reStructuredText is an actively used text markup language created in 2002.
- reStructuredText ranks in the top 20% of languages
- the reStructuredText wikipedia page
- reStructuredText first appeared in 2002
- See also: rest, java, pod, perl, python, cmake, markdown, org, textile, html, asciidoc, txt2tags
- I have 46 facts about reStructuredText. just email me if you need more.
Example code from Linguist:
Contributing to SciPy ===================== This document aims to give an overview of how to contribute to SciPy. It tries to answer commonly asked questions, and provide some insight into how the community process works in practice. Readers who are familiar with the SciPy community and are experienced Python coders may want to jump straight to the `git workflow`_ documentation. Contributing new code --------------------- If you have been working with the scientific Python toolstack for a while, you probably have some code lying around of which you think "this could be useful for others too". Perhaps it's a good idea then to contribute it to SciPy or another open source project. The first question to ask is then, where does this code belong? That question is hard to answer here, so we start with a more specific one: *what code is suitable for putting into SciPy?* Almost all of the new code added to scipy has in common that it's potentially useful in multiple scientific domains and it fits in the scope of existing scipy submodules. In principle new submodules can be added too, but this is far less common. For code that is specific to a single application, there may be an existing project that can use the code. Some scikits (`scikit-learn`_, `scikits-image`_, `statsmodels`_, etc.) are good examples here; they have a narrower focus and because of that more domain-specific code than SciPy. Now if you have code that you would like to see included in SciPy, how do you go about it? After checking that your code can be distributed in SciPy under a compatible license (see FAQ for details), the first step is to discuss on the scipy-dev mailing list. All new features, as well as changes to existing code, are discussed and decided on there. You can, and probably should, already start this discussion before your code is finished. Assuming the outcome of the discussion on the mailing list is positive and you have a function or piece of code that does what you nee
Example code from Wikipedia:
:: some literal text This may also be used inline at the end of a paragraph, like so:: some more literal text .. code:: python print("A literal block directive explicitly marked as python code")Edit
Last updated February 11th, 2019