Skip to content

DOC: Fix tools and release notes to be more markdown compatible. #8424

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

Conversation

charris
Copy link
Member

@charris charris commented Dec 29, 2016

The release notes are rst, but they can be made more markdown compatible
to improve their appearance when posted on github for the releases. It
is not possible to achieve full compatibility, so pavement.py is also
changed so that two versions of the README file are generated by the
write_release_and_log command, a signed version that can be uploaded as
a binary file, and an md version whose content can be cut and pasted
into the release documentation window on github. The changes consist of
the following

  • Use * for marking lists rather than -.
  • Use - strings for underlining H2 headings.
  • Indent file hashes so that they are rendered as code.
  • Change PR link notation in the posting version
  • Do not sign the posting version.

[ci skip]

The release notes are rst, but they can be made more markdown compatible
to improve their appearance when posted on github for the releases. It
is not possible to achieve full compatibility, so pavement.py is also
changed so that two versions of the README file are generated by the
write_release_and_log command, a signed version that can be uploaded as
a binary file, and an md version whose content can be cut and pasted
into the release documentation window on github. The changes consist of
the following

* Use `*` for marking lists rather than `-`.
* Use `-` strings for underlining H2 headings.
* Indent file hashes so that they are rendered as code.
* Change link notation in the posting version
* Do not sign the posting version.

[ci skip]
@charris
Copy link
Member Author

charris commented Dec 29, 2016

This is against the maintenance/1.12.x branch. I will forward port it together with any additional changes to the release notes after 1.12.0 is released.

@rgommers rgommers merged commit f6288bb into numpy:maintenance/1.12.x Dec 29, 2016
@rgommers
Copy link
Member

LGTM, merged.

@charris charris deleted the improve-notes-md-compatibility branch September 19, 2018 14:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants