Skip to content

docs: Improved clarity and formatting within documentation#2033

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

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

Conversation

@feteu
Copy link

@feteu feteu commented Feb 9, 2025

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.

Copy link
Contributor

@chrisinmtown chrisinmtown left a comment

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
Copy link
Author

feteu commented Jul 12, 2025

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

@feteu
Copy link
Author

feteu commented Jul 12, 2025

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

@feteu feteu changed the title Enhance docs docs: Improved clarity and formatting within documentation Jul 13, 2025
@thanhlim
Copy link

thanhlim commented Mar 8, 2026

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