Uploaded image for project: 'Libcloud'
  1. Libcloud
  2. LIBCLOUD-301

Consider switching documentation from custom Markdown to Sphinx + ReST

    XMLWordPrintableJSON

Details

    • Task
    • Status: Open
    • Major
    • Resolution: Unresolved
    • None
    • None
    • Documentation, Website
    • None

    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.

      Attachments

        Activity

          People

            Unassigned Unassigned
            kami Tomaz Muraus
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated: