
Would it be possible to change the presentation style of the Python documentation, so readability and discovery of information is improved (especially for new users). This could be achieved by using standardised sections for each module/class page, making use of HTML tables to structure information (for example the available functions), and better use of white space to aid overview and discovery. The documentation currently sometimes 'feels' like a big blob of text. Pages can be perceived as long and unstructured, especially if you're a new user who's not very familiar with the language yet. https://docs.python.org/3/library/string.html Example of C# documentation page https://msdn.microsoft.com/en-us/library/system.string(v=vs.110).aspx (just an example for inspiration purposes)
participants (1)
-
Jan