Skip to content

[Docs] backend/SSE_README.md is stale: marks shipped auth/per-IP/Redis as TODO and uses deprecated endpoints #848

Description

@grantfox-oss

Telegram (ask questions / claim the issue here first): https://t.me/+DOylgFv1jyJlNzM0

Labels: documentation, Stellar Wave, docs

The SSE README lists three things as TODO that are already shipped, and its examples point at dead endpoints.

SSE_README.md:103-110 has "Add JWT authentication", "Implement per-IP connection limits" and "Add Redis pub/sub" sitting as unchecked TODOs, but all three are done. The curl/endpoint examples still use the deprecated unversioned /events/subscribe and POST /streams, which now return 410 and require auth. Anyone following the doc will hit walls.

What the fix has to hold to

  • the doc matches what's actually implemented
  • examples use endpoints that still work

Done when

  • the shipped production-considerations items are checked off and point at their code; remaining ones stay as TODO
  • examples updated to /v1/events/subscribe and the authenticated v1 stream endpoints
  • note added that /events/subscribe now needs a JWT and the unversioned path returns 410

Where to start
backend/SSE_README.md, that's the whole thing. Rewriting docs/SSE_ARCHITECTURE.md is out of scope. Docs-only, quick.

Metadata

Metadata

Assignees

No one assigned

    Labels

    GrantFox OSSIssue tracked in GrantFox OSSMaybe RewardedIssue may be eligible for a GrantFox rewardOfficial Campaign | FWC26Campaign: Official Campaign | FWC26Stellar WaveIssues in the Stellar wave programdocsDocumentationdocumentationDocumentation tasks

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions