Skip to content
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

blurb: inconsistent spacing in changelog.html #209

Closed
ned-deily opened this issue Jan 9, 2018 · 4 comments
Closed

blurb: inconsistent spacing in changelog.html #209

ned-deily opened this issue Jan 9, 2018 · 4 comments

Comments

@ned-deily
Copy link
Member

ned-deily commented Jan 9, 2018

The rendered changelog.html files produced with blurb and make html have inconsistent spacing between items. Usually, the first changelog topic section (e.g. Security) starts with no blank lines between items but occasionally some subsequent sections will render with a blank link between items; this seems to be often true for the Library section, but not always. This is visible across the blurbified 3.x branches; here's an example with the stable 3.5 docs:

Library section has blank line separator:
https://docs.python.org/3.5/whatsnew/changelog.html#id5

Library section has no blank separators:
https://docs.python.org/3.5/whatsnew/changelog.html#id11

@larryhastings
Copy link
Contributor

blurb generates identical formatting in the RST file. It looks to me like the RST to HTML converter is the one that's being inconsistent, and I have no idea why. But this isn't blurb's doing.

@larryhastings larryhastings removed their assignment Jan 9, 2018
@ned-deily
Copy link
Member Author

But it's easier to blame blurb! (Thanks for investigating.)

@larryhastings
Copy link
Contributor

Note also that the changelog displayed this behavior long before blurb was created. For example, here's the changelog from 3.4.4, released in 2015.

With blank line separator:

https://docs.python.org/release/3.4.4/whatsnew/changelog.html#id152

Without blank line separator:

https://docs.python.org/release/3.4.4/whatsnew/changelog.html#id2

@ned-deily
Copy link
Member Author

I've opened a doc bug: https://bugs.python.org/issue32523

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

No branches or pull requests

2 participants