jonaschn / AndroidAPSdocs

Documentation for AndroidAPS

AndroidAPSdocs

Documentation for AndroidAPS

To view documentation visit https://androidaps.readthedocs.io/

Docs Status

Language	Build	Warning	Links
English
German
Dutch
Czech
Greek
Spanish
Korean
Lithuanian
Russian

Note Issues in the source language "English" should be fixed in (GitHub)[https://github.com/openaps/AndroidAPSdocs]. Issues in translation should be fixed via CROWDIN platform.

Build and Warning

The current build logs of the documentation can be found at on the documentation hosting site, by clicking the docs badge in the column Build.

In the project open the menu Builds section of the documentation, select top Passed version latest (html) and select View raw or click at the bottom grey bar /home/docs/....

The badges are generated with a GitHub Action, and the can be inspected for more details, by clicking on the status badge or here.

• Select the top workflow Build warning
• Select the build of a language, for example build (de)
• Click on the section Build docs to see build output

Broken Links

The badges are generated with a GitHub Action, and the output can be inspected for more details, or by clicking on the status badge, or here.

• Select the top workflow Link Checker
• Select the build of a language, for example check (de)
• Click on the section Link Checker to see link checker output

Note: Links that always failed, but are working correctly should be excluded in the check. Please raise an issue, on one of the channels, or open a pull request in the flow.

Most common issues

The most issues are in restructured text:

• Title underline are too short; they should be at least as long as the title
• Missing new line, after list
• links are broken, OK `Link text <link URL>`_
  • Replaced back quote ` by another type of quote: 'Link text <link URL>"_
  • Missing space before < link `Linktext<link URL>`_
  • Extra space after > link `Linktext <link URL> `_
  • Extra space after ` back tick `Linktext <link URL>` _
• Closing italic or bold text is not done, or a space is added before or after
  • OK **My bold text**
  • Not OK ** My broken bold text **
• Markdown syntax is used in rst files, they are not compatible.
• Directive are translated, https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html

Link issues

The link checker validates both internal and external links. Most common issues:

• Translation headers, cause link anchor form other pages to be broken
• External links are changes
• Link checker receives a redirect on external page
• Link anchor to was generated on page load (have to be excluded)