Aleksei Sviridkin 0b1f389f74
docs(proposal): Gateway API annotation placement clarity proposal (#5919)
* docs(proposal): Gateway API annotation placement clarity proposal

Addresses #5901
Related: #4056

Propose comprehensive solutions for Gateway API annotation placement confusion,
including both short-term documentation improvements and long-term annotation
inheritance strategy.

Documentation improvements are proposed separately in PR #5918 for quick merge.

Co-Authored-By: Claude <noreply@anthropic.com>

* docs(proposal): update Solution 2 to reflect reference implementation

- Change status from draft to provisional
- Add reference to PR #5998
- Update pseudocode: target annotation is now inheritable and overridable
- Update example to show intranet/public target override use case
- Add benefit: solves User Story 2 (per-Route target overrides)
- Update recommendation to include near-term merging of Solution 2

Co-Authored-By: Claude <noreply@anthropic.com>
Signed-off-by: Aleksei Sviridkin <f@lex.la>

---------

Signed-off-by: Aleksei Sviridkin <f@lex.la>
Co-authored-by: Claude <noreply@anthropic.com>
2025-12-27 21:50:32 +05:30
..