Skip to content

fix(css): Restore paragraph spacing in parameter descriptions and response descriptions #10514

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jul 7, 2025

Conversation

hkosova
Copy link
Contributor

@hkosova hkosova commented Jul 2, 2025

Recreated PR #10158 from a fresh branch.

Description

See the before/after screenshots. The issue was that multi-paragraph descriptions in parameters and responses had no space between the paragraphs. (But operation descriptions have proper paragraph spacing.)

I tracked down the issue to these rules:

p {
margin: 0;

p {
margin: 0;

which override the default spacing from:

.markdown, .renderedMarkdown {
p, pre {
margin: 1em auto;

The two abovementioned rules were added in #8214 to fix vertical misalignment of description text compared to other columns.

I think replacing a blanket margin: 0 with a more specific margin-top: 0 applicable only to the 1st paragraph of a block will both fix the paragraph spacing issue AND maintain the fix for #8214.

Motivation and Context

Improve readability of multi-paragraph descriptions.

How Has This Been Tested?

Tested manually by comparing the visual appearance in the online demo (petstore.swagger.io) and in the local build.

Screenshots (if appropriate):

Before After
Multi-paragraph parameter description before the fix Multi-paragraph parameter description after the fix
Multi-paragraph response description before the fix Multi-paragraph response description after the fix

Checklist

My PR contains...

  • No code changes (src/ is unmodified: changes to documentation, CI, metadata, etc.)
  • Dependency changes (any modification to dependencies in package.json)
  • Bug fixes (non-breaking change which fixes an issue)
  • Improvements (misc. changes to existing features)
  • Features (non-breaking change which adds functionality)

My changes...

  • are breaking changes to a public API (config options, System API, major UI change, etc).
  • are breaking changes to a private API (Redux, component props, utility functions, etc.).
  • are breaking changes to a developer API (npm script behavior changes, new dev system dependencies, etc).
  • are not breaking changes.

Documentation

  • My changes do not require a change to the project documentation.
  • My changes require a change to the project documentation.
  • If yes to above: I have updated the documentation accordingly.

Automated tests

  • My changes can not or do not need to be tested.
  • My changes can and should be tested by unit and/or integration tests.
  • If yes to above: I have added tests to cover my changes.
  • If yes to above: I have taken care to cover edge cases in my tests.
  • All new and existing tests passed.

Copy link
Contributor

@glowcloud glowcloud left a comment

Choose a reason for hiding this comment

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

Hi @hkosova,

Looks good, just one small change for the response description.

@glowcloud
Copy link
Contributor

@hkosova Thank you for the changes! LGTM now.

@glowcloud glowcloud merged commit efe6eb5 into swagger-api:master Jul 7, 2025
8 checks passed
@hkosova hkosova deleted the fix/paragraph-spacing-2 branch July 7, 2025 09:43
swagger-bot pushed a commit that referenced this pull request Jul 7, 2025
## [5.26.2](v5.26.1...v5.26.2) (2025-07-07)

### Bug Fixes

* **style:** restore paragraph spacing in parameter and response descriptions ([#10514](#10514)) ([efe6eb5](efe6eb5))
@swagger-bot
Copy link
Contributor

🎉 This PR is included in version 5.26.2 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants