Skip to content

Follow up cross-domain guide polish after PR #250 #252

@mickdarling

Description

@mickdarling

This tracks the lower-priority editorial and consistency cleanup intentionally deferred from PR #250.

Context: the current PR keeps the cross-domain implementation guide accurate enough to merge, while preserving a smaller review scope.

Open items:

  • Trim or diversify the repeated identifier examples in Section 2 so they add value beyond the Section 1 table.
  • Revisit normative-sounding RFC 2119 wording in this informative guide (for example the lifecycle-state recommendation) and soften it where appropriate.
  • Replace generic "pagination parameters" wording with the concrete first / after terminology used elsewhere in the spec.
  • Consider aligning the Section 8.1 operation template endpoint casing with the semantic-endpoint / introspection guidance for extra consistency.

This follow-up is intentionally separate from PR #250 so the implementation-guide addition can land cleanly first.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions