Improving documentation

[federico-pepe]

• Documentation should be fully accessible on the website with sound examples
• Revise the whole documentation to avoid repetitions and holes
• Create a reference organised by categories and move it on the website as well
• Create a Getting Started guide
• Separate the Mag Pi articles from the main tutorials
• I would suggest to stop referring to the Raspberry Pi in the tutorial to avoid confusion because some people - myself included - run Sonic Pi on Mac, PC or Linux
• Create translations guidelines, I believe that function's name should be translated
• Create a glossary
• Move Minecraft's articles into a new section
• Video Tutorial

[samaaron]

Thanks for these suggestions. I think these are better placed in a wiki page so they can be discussed. For example, item 2 would be better expanded with a list of the holes you observe. Also, translating function names isn't something we intend to do - but it would be good to have a page explaining our rationale for that decision.