Documentation Upgrade Working Group: Difference between revisions
Jump to navigation
Jump to search
| Line 4: | Line 4: | ||
=== How will block docs be different between 3.x and 4.0? === | === How will block docs be different between 3.x and 4.0? === | ||
=== Will all 4.0 blocks have a different API, or only those which use multiple processors? === | |||
=== Use of Doxygen / Sphinx / Wiki === | === Use of Doxygen / Sphinx / Wiki === | ||
Revision as of 00:32, 19 September 2023
The purpose of this group is to address issues related to documenting blocks in a manner which uses source code of the blocks as the basis of all related documents.
Items to address
How will block docs be different between 3.x and 4.0?
Will all 4.0 blocks have a different API, or only those which use multiple processors?
Use of Doxygen / Sphinx / Wiki
Examine current process of generating the doxygen manual
The GNU Radio Manual and C++ API Reference document currently does not reflect the current release version.
Create new process / work flow to generate user-friendly block docs
Current Wiki Block docs have the following sections:
- A functional description
- Parameters
- An example flowgraph
- Links to the source code
- C++ or Python
- Include files
- YML file
Road map for group
What are the plans to move forward?