Skip to content

GitLab

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
D
dorie
  • Project overview
    • Project overview
    • Details
    • Activity
    • Releases
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 31
    • Issues 31
    • List
    • Boards
    • Labels
    • Service Desk
    • Milestones
  • Merge Requests 9
    • Merge Requests 9
  • Operations
    • Operations
    • Incidents
    • Environments
  • Analytics
    • Analytics
    • Repository
    • Value Stream
  • Wiki
    • Wiki
  • Members
    • Members
  • Collapse sidebar
  • Activity
  • Graph
  • Create a new issue
  • Commits
  • Issue Boards
  • dorie
  • dorie
  • Issues
  • #143

Closed
Open
Opened Feb 11, 2019 by Lukas Riedel@lriedelOwner

Switch to "Read the Docs" for automated documentation building and hosting

Description

We currently use Netlify as our provider for the HTML online documentation. We only employ manual deploys right now, which means that we cannot make use of branch deployment, where every branch or tag gets a certain public URL. However, we cannot use the Netlify automated builds because or documentation build process requires CMake and Doxygen, both of which are not provided in the Netlify environment.

Read the Docs, on the other hand, offers a larger build environment which contains Doxygen (but not CMake). It features a clearer overview of the different versions of the documentation, and downloads of HTML or PDF files. See the Read the Docs docs for an example. I would like to switch to it and use its automated external build system to keep the documentation up to speed with the actual code development.

Proposal

Switch to Read the Docs!

Management tasks:

  • Create a Read the Docs account.
  • Add an outgoing webhook and register it with the account.

Repository tasks:

  • Make Sphinx and Doxygen documentation independent from CMake, such that running them does not require configuring the project.

    • Create a complete Doxygen configuration file and stop using the DUNE Doxygen target.
    • Only use local paths in conf.py and stop configuring it.
  • Create a readthedocs.yml configuration file.

  • Add GitLab Environment for quickly referencing the docs.

How to test the implementation?

CI pipeline passes. Docs are deployed to Read the Docs.

Related issues

See #52

Edited Feb 11, 2019 by Lukas Riedel
To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information
Assignee
Assign to
None
Milestone
None
Assign milestone
Time tracking
None
Due date
None
Reference: dorie/dorie#143