[LIBCLOUD-301] Consider switching documentation from custom Markdown to Sphinx + ReST

• Type: Task
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Component/s: Documentation, Website
• Assignee: Unassigned
• Reporter: Tomaz Muraus
• Created: 01/Mar/13 22:28
• Updated: 28/Dec/16 05:56

Description

Consider moving documentation (http://libcloud.apache.org/docs/) to Sphinx.

Reasons:

• It's more idomatic / in Python world Sphinx is the standard
• We can also host it on readthedocs which is turning out to become a defacto standard for hosting docs for Python libraries

Downsides:

• Currently docs are constitent with other website content and use Markdown. For Sphinx we would need to use ReST.