fix(openapi): docs

[shikhar]

No description provided.

[shikhar]

(this was wrong)

[greptile-apps]

Greptile Overview

Greptile Summary

This PR fixes documentation comments in the OpenAPI schema definitions to improve grammar and clarity:

• Fixed plural agreement in ListAccessTokensRequest ("ID" → "IDs", "begins" → "begin")
• Fixed plural agreement in ListStreamsRequest ("name" → "names")
• Corrected the description of start_after field which previously duplicated the prefix description
• Removed redundant documentation for the Header struct (the doc comment was weirdly repeated in the OpenAPI schema)

Confidence Score: 5/5

• This PR is safe to merge with no risk
• The changes are purely documentation fixes with no functional code changes, improving grammar and removing duplicate comments
• No files require special attention

Important Files Changed

Filename	Overview
api/src/v1/access.rs	Fixed grammar in documentation comments: "ID" → "IDs" and "begins" → "begin" to match plural subjects
api/src/v1/stream/mod.rs	Fixed grammar in documentation comments and removed duplicate/incorrect comment for start_after field; removed redundant doc comments for Header struct

Sequence Diagram

sequenceDiagram
    participant Dev as Developer
    participant OpenAPI as OpenAPI Generator
    participant Doc as API Documentation
    
    Dev->>OpenAPI: Update doc comments in access.rs
    Note over OpenAPI: Fix grammar: "ID" → "IDs"<br/>"begins" → "begin"
    OpenAPI->>Doc: Generate improved docs for<br/>ListAccessTokensRequest
    
    Dev->>OpenAPI: Update doc comments in stream/mod.rs
    Note over OpenAPI: Fix grammar: "name" → "names"<br/>Correct start_after description<br/>Remove redundant Header docs
    OpenAPI->>Doc: Generate improved docs for<br/>ListStreamsRequest & Header
    
    Doc-->>Dev: Clearer API documentation

Loading