Skip to content

Followups from #1191: polish schema customization guide#1197

Open
myronmarston wants to merge 1 commit into
mainfrom
myron/schema-customization-guide-followups
Open

Followups from #1191: polish schema customization guide#1197
myronmarston wants to merge 1 commit into
mainfrom
myron/schema-customization-guide-followups

Conversation

@myronmarston
Copy link
Copy Markdown
Collaborator

Summary

  • Shorten nav_title to "Schema Customization", reorder before "Custom Resolvers" in the Guides dropdown
  • Widen guides dropdown (w-56) to accommodate the longer title
  • Text fixes: "needs and conventions", "can be configured via"
  • Clarify customize_derived_type_fields is for EG-defined fields without a user-defined counterpart (pageInfo, nodes, etc)
  • Remove unnecessary t.index from examples that don't require indexing
  • Add api_doc_url Liquid tag: links to latest released version when the anchor exists there, falls back to main for unreleased APIs — automatically switches when we release
  • Convert all API doc links across the site to use the new tag

Test plan

  • bundle exec rake site:build passes
  • namespace_type link resolves to main (not yet in v1.2.0)
  • All other links resolve to v1.2.0
  • Visual check: guides dropdown width, ordering

🤖 Generated with Claude Code

- Shorten nav_title to "Schema Customization", reorder before Custom Resolvers
- Widen guides dropdown (w-56) to accommodate longer title
- Text fixes: "needs and conventions", "can be configured via"
- Clarify customize_derived_type_fields is for EG-defined fields without
  a user-defined counterpart (pageInfo, nodes, etc), not for fields
  derived from user-defined fields
- Remove unnecessary t.index from examples that don't require indexing
- Add api_doc_url Liquid tag that auto-selects latest released version
  when the anchor exists there, falling back to main for unreleased APIs
- Convert all API doc links across the site to use the new tag

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@myronmarston myronmarston force-pushed the myron/schema-customization-guide-followups branch from b538d2e to 2e952f9 Compare May 20, 2026 00:51
@myronmarston myronmarston changed the base branch from main to myron/fix-1021 May 20, 2026 00:52
@myronmarston myronmarston marked this pull request as ready for review May 20, 2026 01:40
Base automatically changed from myron/fix-1021 to main May 20, 2026 14:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant