Page MenuHomePhabricator

[MITKDoc] Documentation Refurbish - Developer Manual
Open, LowPublic

Description

Update and restructure the developer manual.

Related Objects

StatusAssignedTask
OpenNone

Event Timeline

kompan triaged this task as Normal priority.Jul 27 2020, 12:04 PM
kompan created this task.

In the developer manual section, the table of contents is repeated in each section and subsection. This is not a show-stopper, but doesn't look very nice and should be cleaned up at some point.

Deleted branch bugfix/T27608-DocumentationRefurbish-DeveloperManual.

I re-created the branch above, branching off from the latest develop branch.

So far, Sarina and I changed the \section,\subsection to headings <h1>, <h2,>..., such that the table of contents doesn't have too much depth (which is confusing to navigate through). However, the more sensible way would be to keep the \section structure and instead adjust the depth of the doxygen TOC_INCLUDE_HEADINGS. The default depths is 5.

kompan lowered the priority of this task from Normal to Low.Sep 25 2020, 9:53 AM

Deleted branch bugfix/T27608-DocumentationRefurbish-DeveloperManual.

@kompan What is the status here? Is it finish. If not, what has to be done to close it. Should be done before we make a release in january and if much is left, we should know what to do. Thanks.