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

cEP 0: Replace markdown for cEPs #129

Open
jayvdb opened this issue May 9, 2018 · 2 comments
Open

cEP 0: Replace markdown for cEPs #129

jayvdb opened this issue May 9, 2018 · 2 comments

Comments

@jayvdb
Copy link
Member

jayvdb commented May 9, 2018

markdown is a crazy language. rST is slightly better, and that aligns better with being a Python org.

However, we should be a multilingual org, so it is useful to force ourselves to switch languages, testing different bears in the process.

For one, asciidoc has better table support.
http://www.methods.co.nz/asciidoc/newtables.html

@jayvdb jayvdb changed the title cEP 0: Use asciidoc for cEPs cEP 0: Replace markdown for cEPs May 9, 2018
@jayvdb
Copy link
Member Author

jayvdb commented May 9, 2018

A nice feature of rst is that we have a bear which should be able to check the syntax of python inside code blocks.
c.f. #124 (comment)

@jayvdb
Copy link
Member Author

jayvdb commented Jun 6, 2018

Another pretty bad case. #124 (comment)

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

No branches or pull requests

2 participants