apollographql / apollographql/federation

🐛 📝 New in Federation 2 and Subgraph spec examples are contradicting

Open
#2,004 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
725
Forks
276
Avg merge
1h 47m
Merged PRs (30d)
1

Description

In what's new it is said that `entities do not have an "originating subgraph." `, hence you do not have to use `extend type`. But all examples in the subgraph spec for augmenting types or using types from other subgraphs are with `extend type`. This is very confusing.

https://www.apollographql.com/docs/federation/federation-2/new-in-federation-2
https://www.apollographql.com/docs/federation/federation-spec

![image](https://user-images.githubusercontent.com/86342787/180377474-b27ab30f-8c2e-4c24-8f0e-e028dfab54b1.png)

Contributor guide

Open the contributing guide

Research direction

Compare the “What’s new in Federation 2” page with the Federation spec examples at the two linked documentation URLs, focusing on the guidance about originating subgraphs and `extend type`. Update the wording or examples so they agree, and confirm that the explanation and examples no longer contradict each other.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.