Actions
Documentation #36243
closedmgr/dashboard: code documentation
% Done:
0%
Tags:
Backport:
nautilus
Reviewed:
Affected Versions:
Pull request ID:
Description
Intro¶
This is review of a bunch of tools suitable for documenting the code. This is aimed at complementing the existing doc sources:- Ceph docs (doc/mgr/dashboard.rst): user focus
- README: user focus
- HACKING.rst: dev focus (introductory)
- Swagger API docs: dev focus (as long as API is not meant to be consumed externally).
- Architecture docs
- Implementation docs
- General purpose doc generators
- **Sphinx** is extensively used in Ceph docs. There are different plugins for JS support, most based on JSDoc: sphinx-js.
- Language-specific generatos:
- **Compodoc** is an Angular focused tool for auto-doc'ing, also parsing JSDoc tags. [Screenshots] [Online demo]
- **TypeDoc**: Typescript specific.
Updated by Ernesto Puerta over 5 years ago
- Description updated (diff)
- Status changed from New to In Progress
Updated by Ernesto Puerta about 5 years ago
- Status changed from In Progress to Fix Under Review
- Pull request ID set to 27433
Updated by Ernesto Puerta about 5 years ago
Ceph-Dashboard docs landing page as generated by compodoc:
Updated by Lenz Grimmer about 5 years ago
- Translation missing: en.field_tag_list set to development
- Status changed from Fix Under Review to Pending Backport
- Target version set to v15.0.0
- Backport set to nautilus
Updated by Nathan Cutler about 5 years ago
- Copied to Backport #39345: nautilus: mgr/dashboard: code documentation added
Updated by Nathan Cutler almost 5 years ago
- Related to Bug #39556: npm problem causes "make-dist" to fail when directory contains colon character added
Updated by Sebastian Wagner over 4 years ago
- Status changed from Pending Backport to Resolved
backport was merged. resolve.
Updated by Nathan Cutler about 3 years ago
- Related to deleted (Bug #39556: npm problem causes "make-dist" to fail when directory contains colon character)
Updated by Ernesto Puerta about 3 years ago
- Project changed from mgr to Dashboard
- Category changed from 132 to General
Actions