I have contributed several improvements to README.md. Here is the list of changes and their motivations:
Adjusted text formatting to vary sizes in headings, subheadings, and normal text.
Previously, all of the text was of the same size. I added variation in text size to the sections so that they are more skimmable. I also increased the text size overall for readability purposes. Finally, I changed README's extension from txt to md for a more readable font.
Added badges for Python versions, PyPi versions, and download count.
I added some badges to express attributes of PyBrain. These attributes are the versions of Python and PyPi that PyBrain works with, which is helpful for newcomers to determine compatibility. The project's download count is also interesting to know.
Added a more informative description under the PyBrain title.
There was previously only the subtitle that PyBrain was "the Python Machine Learning Library," but no further description. So, I added a brief description that summarizes PyBrain's functionalities.
Added a table of contents.
There was previously no table of contents, so I added one for easier navigation of the sections.
Added a section for main features.
I linked the main features of PyBrain as an introduction to newcomers.
Added a section for examples.
I linked the directory featuring example usages of PyBrain so that newcomers can get an idea of how to start using the library.
Added a section for getting help.
I linked StackOverflow questions tagged with PyBrain.
Added a section to inform users of how to contribute to the repository.
This section clarifies instructions to users who wish to contribute something to PyBrain, such as myself.
I have contributed several improvements to README.md. Here is the list of changes and their motivations: