Skip to content

docs: Improved clarity and formatting within documentation#2033

Open
feteu wants to merge 25 commits into
spec-first:mainfrom
feteu:enhance-docs
Open

docs: Improved clarity and formatting within documentation#2033
feteu wants to merge 25 commits into
spec-first:mainfrom
feteu:enhance-docs

Conversation

@feteu

@feteu feteu commented Feb 9, 2025

Copy link
Copy Markdown

Fixes #2032.

Changes proposed in this pull request:

  • Improved clarity and formatting in CLI documentation
  • Enhanced documentation for context variables and ASGI scope
  • Refined language and clarity in the Connexion Cookbook
  • Fixed grammar, punctuation, and typos in multiple .rst and .md files, including:
    • index.rst
    • lifespan.rst
    • middleware.rst
    • quickstart.rst
    • request.rst
    • response.rst
    • security.rst
    • swagger_ui.rst
    • testing.rst
    • v3.rst
    • validation.rst
    • README.md

These updates enhance readability and maintain consistency across the documentation.

Comment thread docs/index.rst Outdated
Comment thread docs/lifespan.rst Outdated
Comment thread docs/lifespan.rst
Comment thread docs/security.rst Outdated
Comment thread docs/testing.rst Outdated
Comment thread docs/testing.rst
Comment thread docs/validation.rst Outdated

@chrisinmtown chrisinmtown left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This PR cleans up many small documentation problems and I recommend merging it. I added a couple tiny comments. Please note I'm a fellow user, not a maintainer.

@feteu

feteu commented Jul 12, 2025

Copy link
Copy Markdown
Author

@chrisinmtown thanks for taking the time to quickly go over the adjustments. I've fixed most of the suggestions.

@feteu

feteu commented Jul 12, 2025

Copy link
Copy Markdown
Author

@Ruwann is this ready to go or do you have any objections?

Comment thread docs/context.rst
@feteu feteu changed the title Enhance docs docs: Improved clarity and formatting within documentation Jul 13, 2025
@thanhlim

thanhlim commented Mar 8, 2026

Copy link
Copy Markdown
Contributor

I pulled in your changes because the project is getting farther behind, and now the sphinx build it breaking. So hopefully, the maintainers will take that one as well and my other PR to help with otel.

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.

docs: Documentation Cleanup and Consistency Improvements

3 participants