docs: link directive

[shorgi]

Clarify required @link directive for Fed 2

[changeset-bot]

⚠️ No Changeset found

Latest commit: b2e7b0c

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[svc-apollo-docs]

✅ Docs preview ready

The preview is ready to be viewed. View the preview

File Changes

0 new, 2 changed, 0 removed

* graphos/reference/federation/directives.mdx
* graphos/reference/federation/subgraph-spec.mdx

Build ID: e9a3f8264f5cd82887c57744

URL: https://www.apollographql.com/docs/deploy-preview/e9a3f8264f5cd82887c57744

[codesandbox-ci]

This pull request is automatically built and testable in CodeSandbox.

To see build info of the built libraries, click here or the icon next to each commit SHA.

[Meschreiber]

Thanks for tackling so quickly!

[Meschreiber]

Not sure if "opt in" requires the quotes, but I'm a minimalist when it comes to characters like " and ( so take that with a grain of salt. :P

[dariuszkuc]

The import list of this definition must include

Imports are optional and it is perfectly fine to skip it. Side effect is that without explicit imports those directives have to be namespaced to the spec (or provided alias), i.e. @key becomes @federation__key without explicit import

[shorgi]

thanks @dariuszkuc, do these edits make sense:

Suggested change

	Subgraph schemas "opt in" to Federation v2 features by applying the `@link` directive to the `schema` type. The `import` list of this definition must include each federation-specific directive that the subgraph schema uses. In the example below, the schema uses the `@key` and `@shareable` directives:
	Subgraph schemas opt in to Federation v2 features by applying the `@link` directive to the `schema` type. You can optionally add an `import` list to this definition to include each federation-specific directive that the subgraph schema uses. In the example below, the schema uses the `@key` and `@shareable` directives: