Questions tagged [documentation-generation]
A documentation generator is a programming tool that generates documentation intended for programmers (API documentation) or end users (End-user Guide), or both, from a set of specially commented source code files, and in some cases, binary files.
809
questions
0
votes
0
answers
7
views
Automated systems documention for a spring boot project
I'd like to auto-document my spring boot projects.
Basically I'd like to list:
all cronjobs
all databases configured
all implementations of resttemplate
Is there such a tool out there, or do I have ...
0
votes
1
answer
8
views
Any standard way to export structured js/json from jsdoc comments
I want to use jsdoc comments from a javascript file inside an interactive component (like property definitions appearing on hover), but I can’t find a way to do that as jsdoc is primarily intended to ...
0
votes
0
answers
22
views
How do I get doxygen to list all namespace members on the namespace documentation page?
In a C++ project of mine, have a bunch of functions in some namespace; and both the functions and the namespace have doxygen comments. I can see the function documentation through the doxygen page ...
0
votes
0
answers
20
views
What is the easiest way to create an editable string, store in a variable, and re-display in multiple places using a MDX based static site generator?
Problem Statement:
I want to create a website with beginner friendly guides of how to do some basic bash and Kubernetes automation. (Beginner friendly as in Explanations + copy paste-able code ...
0
votes
1
answer
100
views
Doxygen With Flutter
dose any one used doxygen to generate a Documentation for flutter project before ,
I know about dartdoc extension , but I need to generate it with doxygen format ,
I found someone generated a doc for ...
0
votes
0
answers
59
views
Linking Doxygen files that are generated by Gitlab pipeline to adoc file
What I am trying to do is to link a documentation made by Doxygen to a file written in adoc format. I was able to do so when everything was on my Desktop. I used:
link:path/to/documentation/...
0
votes
1
answer
27
views
Generate docfx site using existing docfx.json
So I have a docfx.json which is configured correctly and targets the correct directories. What I'm wondering is how can I generate site using that docfx.json from scratch.
E.g. I have a blank ...
0
votes
0
answers
51
views
Generate documentation with python file that has errors
Background:
My group is working on a project and I am creating the documentation that will also create a html documentation (like pdoc).
Due to how the project evolved. The code is across a number of ...
0
votes
1
answer
78
views
How to link a Table of Contents (TOC) from index.rst to README.rst?
I have some sphinx documentation inside my docs/ folder. There I have a typical structure of some handwritten and dynamically generated documentation from code (Python). I would like to have a very ...
1
vote
0
answers
61
views
Sphinx show values next to define macros
I am generating documentation for a C++ project using Doxygen, doxyrest and Sphinx. For Sphinx, I'm using the Sphinx Book Theme.
I wanted to know if there exists a possibility, when accessing a macro (...
0
votes
0
answers
91
views
Custom id in Sphinx documentation generator
How to create a custom Id for headlines in Sphinx (Jinja)?
Sphinx defines Id same with the headline text by default, but I want to define a different Id
If you write this in text file :
Headline text
=...
0
votes
0
answers
14
views
Display all APIs and parameters in Web API 2.0
Is there a way to display all of the APIs which is something like this.
I fear that as I code more, I will forget the parameters and the service name and I would need to open my source code to share ...
0
votes
1
answer
195
views
customising pdoc automatically generated documentation for python
I used pdoc3 to automatically generate documentation from the docstrings at the beginning of each python class/function by executing the following
pdoc3 --html ambit_stochastics
The resulting ...
0
votes
1
answer
112
views
How to change the width of a code block in an asciidoc file?
Is there any way to modify the width of a source code block in an asciidoc file instead of having to scroll horizontally to show its content?
The Asciidoc documentation does not say if changing the ...
0
votes
1
answer
47
views
How to use .vsdx file in Doxygen for Document generation
is it possible to include a .vsdx Microsoft Visio file into source code as a image and use doxygen for compiling the documentation. If so, How?
0
votes
0
answers
36
views
C# xml comments: create help file with index from custom keywords
Our codebase has become quite large in the last years, so we want to create a kind of help file that helps us find existing functionality and avoid duplicate code and unnecessary work.
This help file ...
-2
votes
1
answer
120
views
Is there an easy and convenient way to use SQL Server extended properties for automatic documentation?
To use extended properties for documentation is a striking thought, or to have a easy way to tag your tables, but to set a snippet of documentation you have to execute something like:
EXECUTE ...
0
votes
1
answer
88
views
Sphinx rtd docs dropdown only works post click
I have created an rtd themed documentation for my package using sphinx and sphinx_rtd_theme. The index.rst is as follows:
Welcome!
.. toctree::
:maxdepth: 1
:glob:
src
Indices and tables
==...
1
vote
0
answers
221
views
Ways to generate gRPC API documentation (specifically for Java, Spring Boot)
I would like to document the gRPC API in my Spring Boot application. The sources on the web that I have looked through suggest something like mapping endpoints to REST and then generating ...
1
vote
0
answers
83
views
Force sphinx autosummary to display the first line after the heading in module docstrings in modules' summary table
For classes/functions, sphinx's autosummary extension can generate a nice table summarizing the list of available classes/functions in a particular module, such that the first column consists a list ...
0
votes
1
answer
25
views
Is there any standard template or considered a suitable format for writing test documentation for a project?
I am working on a Django-Rest-React project, and I need to create test documentation for my team. I generally know what test documentation should contain, like a checklist, test case, use case, bug ...
0
votes
0
answers
40
views
Database API documentation
I would like to have some sort of informal database documentation that is an easy way for someone to read what the structure is and detailed comments about what we are doing. I would basically like to ...
0
votes
0
answers
30
views
Document service dependencies using Mass transit or RabbitMQ
Is there a way to somehow automatically generate documentation of dependencies between services using MassTransit library or RabbitMQ since we are already using it?
Mass transit is the one point in ...
0
votes
0
answers
25
views
Mixed Language documentation generation in Xcode Framework
I have created a sample objective c framework in Xcode where I also created a swift file. This is the navigation controller showing one swift file and another objective c class (NewFramework).
When I ...
0
votes
0
answers
24
views
How can I convert my xocde project into xcode package?
I have a regular xcode project with swift classes and pods. I need to generate documentation for the project. But, I came to know that xcode 13 buildin documentation generator (DocC) (product -> ...
2
votes
1
answer
273
views
Furo Sphinx theme uppercases too much in API documentation
I am a beginner in documentation with Sphinx. I wanted to produce numpy style documentations. Therefore, I used numpydoc extension. Numpy uses pydata theme, however I chose furo. I understand that ...
0
votes
0
answers
67
views
Documenting AWS API Gateway APIs
I am trying to generate documentation for the API gateway APIs I have developed. I go to the method. Click on my method. It shows me a screen with four tiles. One of them is method response. I go to ...
0
votes
1
answer
76
views
Auto Generate Documentation based on FluentValidator written
is there a way to generate documentation based on FluentValidator that has been written for request?
I need information like: the field is NotEmpty(), MaximumLength(40), etc.
Please direct me
Thank ...
0
votes
0
answers
48
views
How to force sphinx to only use filename as heading in a multi-level project?
I have a sample project:
docs/
src/
----| model/
------------| first.py
------------| second.py
----| utils
------------| some_helper.py
------------| some_organizer.py
----| io
------------| ...
1
vote
1
answer
118
views
Unable to authenticate with Confluence server for Sphinx documentation
I am using sphinx for building documentation in confluence.I am able to make html file using sphinx. But when I am trying to connect confluence using the "make confluence" command it's ...
0
votes
1
answer
440
views
Generate documentation with phpDocumentor (phpdoc) for Laravel package model
I'm trying to use phpDocumentor to generate my Laravel package documentation, but I'm finding not-as-easy-as-I-tought to generate a usage-oriented documentation.
What i mean is: how should I write ...
1
vote
0
answers
111
views
How can I link functions in a Sphinx table?
I have added functions to the "Usage" section of my Read the Docs project which I am designing with Sphinx. I'm looking for a way that I can automatically link each function in a table or ...
0
votes
0
answers
39
views
doxyrest command returns "duplicate member id group..."
I'm generating documentation for my code using doxygen, doxyrest and sphinx-build commands.
No warnings while using doxygen Doxyfile, but when I type in doxyrest -c doxyrest-config.lua to generate rst,...
2
votes
2
answers
2k
views
Setting up Swagger in an existing PHP project
(Please bear with me, I've never set up something like this so I'm feeling my way in the dark)
I've watched some videos and read the documentation on installing swagger-php that I found here, and am ...
0
votes
0
answers
63
views
Add custom items to Sphinx Documentation navbar
I'm using Doxygen, together with doxyrest and Sphinx to generate beautiful documentation for my code. To make it look even better, I'm using the sphinx-book-theme, which, in my opinion, doesn't ...
2
votes
0
answers
351
views
How to reference files outside of Docusaurus root folder
My team and I are looking to implement a documentation system that allows engineers to put markdown files within a specified folder in each of their service root directories. Since we are in a ...
1
vote
1
answer
271
views
Mixing code documentation with code by appending various notes to sections?
Consider the following minimal example:
docs/index.rst
* :ref:`modindex`
docs/modules.rst
exampleproject
==============
.. toctree::
:maxdepth: 4
exampleproject
.. ...
1
vote
1
answer
108
views
Roxygen2: @return mismatched braces or quotes
I am using rowxygen2 (version 7.1.1) and cannot get my function return list value to parse properly. Imput:
#' @return A list with the following fields:
#' \describe{
#' \item{ID}{The speaker / ...
1
vote
1
answer
67
views
Eleventy: Deploying static site into local file system
I have created a static site for my project documentation using Eleventy and want to deploy into local file system. I tried with many method but no luck.
Actually I want to upload the static site/...
0
votes
0
answers
38
views
package for getting automatic flutter documentation for your flutter app
Hey guys I wanted to know if there is some automatic documentation package for flutter such as the dartdoc package for Dart documentation.
0
votes
1
answer
58
views
How to write docstrings for functions written in functional paradigm using pipetools
I use pipetools to write functions, which is a "functional plumbing library for python".
An example function (from their docs):
pyfiles_by_length = (pipe
| os.listdir
| where(X....
0
votes
2
answers
90
views
Running Apple DocC as a Apple Help Book file
With the introduction of DocC for generating documentation from source code, is it possible to take the output of DocC and use it as the source of truth for an Apple Help Book (for use inside of a ...
0
votes
2
answers
314
views
Can a CHM file be re-built so all html files are local?
Is there a way to take a .chm file that is already compiled, and rebuilt it so it's html files are stored locally? I do not have access to the installer that generated the chm file. The issue is that ...
0
votes
1
answer
254
views
How to hide TOC from sidebar in sphinx.ext.autosummary?
I need Sphinx autosummary extension to generate stub using :toctree: generated/ but I also want to prevent TOC entries from appearing in the HTML sidebar. Consider following docstring:
MySubPackage (...
2
votes
0
answers
47
views
Documenter.jl: add parameters in @index block
When creating a documentation using documenter.jl, is it possible to add the parameters of a function when displayed from a
```@index
```
block? I.e. say I have a function f(x), I want f(x) to be ...
0
votes
0
answers
17
views
How to show python call diagramm without evaluation?
Say I have a folder with N files. An environment I can start my project from. Yet no tests to evaluate all the code I have. How to show python call diagramm without evaluation of all methods I have in ...
0
votes
0
answers
15
views
Are there any tools for easily creating structure charts?
I need to create a structure chart as part of a school assignment, but all the normal chart and graph creation programs I have used such as yEd and draw.io lack the symbols needed.
Does anyone know of ...
1
vote
0
answers
107
views
Documenter can't find docstring
I'm trying to build a documentation using documenter.jl and run into a weird error.
In one of the .md files, I have a few @docs blocks. It looks as follows:
##Functions
```@docs
f
```
##Some more ...
0
votes
1
answer
31
views
Filter out diagrams from document generation based on some kind of status
Problem: Document options let you use filter elements etc., but no diagrams.
I've tried this using name prefixes and filter them, without success.
I would be thankful for help :)
1
vote
0
answers
68
views
Documenter.jl build hanging
I am building a documentation with documenter.jl. Everything was working fine, until I pulled a new version of the repo from GitHub (and pushed my current repo onto GitHub). I don't think there was ...