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.
763
questions
0
votes
0answers
19 views
document generator for PostgreSQL
I am looking for a program to automatically document PL/pgSQL scripts (in PostgreSQL), something like javadoc that interprets some tags placed in the source code (e.g. for input parameters of stored ...
-1
votes
0answers
6 views
What kind of site generators are used for typescript and microsoft docs
What kind of site generator Microsoft used for Docs https://docs.microsoft.com/en-us/dotnet/csharp/
and Typescript website https://www.typescriptlang.org/
0
votes
0answers
4 views
Docfx not filtering out methods that are decorated with attribute
My filterConfig file is:
apiRules:
- exclude:
hasAttribute:
uid: System.ComponentModel.EditorBrowsableAttribute
ctorArguments:
- System.ComponentModel.EditorBrowsableState....
1
vote
0answers
34 views
Doxygen-like documentation for python code from a C++ project
I've been working on this C++ library (using C++17) for quite some time now. Most of my users want it for Python because they do not know C++, so I had to write an interface of the library for Python. ...
0
votes
0answers
13 views
TypeDoc how do i generate documentation for internal functions
I'm trying to generate documentation for my TypeScript/React Native project. But from what I've seen you need to add an export to a function for TypeDoc to generate documentation. However, most of my ...
0
votes
0answers
12 views
How to document an API with all possible errors from laravel API testing?
I want to ask about API Documentation in laravel.
At this point I've created a back-end with laravel which provides about 30 APIs. I have tested all of these APIs using Http Test laravel (https://...
0
votes
1answer
26 views
JSDOC: How to document a function within of simple object
I need to document a simple object and I'm failing to find a documentation or tutorial how to document @param and @returns for the inner methods. If I put them above the respective method (xyz), they ...
0
votes
1answer
56 views
How to use Sphix's sphinx.ext.coverage's coverage_show_missing_items?
Sorry, I am a newbie trying to add Sphinx to auto-generate documentation for a Django project and also ensure sufficient documentation coverage of the project.
I want to configure Sphinx to tell me ...
1
vote
1answer
23 views
Swift: Swift doc github documentation tool - unable to find correct path
I'm trying to install and use the following auto-generating documentation tool for my Swift project:
https://github.com/SwiftDocOrg/swift-doc
It is installed correctly however when I try to generate I ...
0
votes
0answers
29 views
How to activate zoom on images on mkdocs
I'm trying to generate a documentation with mkdocs like this documentation
https://signalfx.github.io/observability-workshop/latest/smartagent/
I added {: .zoom} to my images but i can't zoom on the ...
0
votes
1answer
23 views
rust/mdBook: 404 page displays without CSS if the address is a subfolder
Using mdBook for a documentation website, I have a displaying error when the 404 page is in a subfolder.
Example:
https://docs.luos.io/wrong-subfolder/wrong-page.html -> 404 page without CSS (...
1
vote
1answer
54 views
Pdoc: doesn't generate documentation
I was trying to generate documentation for my python package using pdoc, and it didn't generate any documentation when I ran the command py -m pdoc --html [package name].It outputs the error ...\...
0
votes
0answers
11 views
How to customize dgeni pipeline
I'm using dgeni to extract jsDoc tags from a javascript codebase and generate markdown documentation files.
Dgeni workflow relies of the concept of pipelining. In dgeni this means that you can define ...
2
votes
0answers
48 views
Customize dgeni pipeline for document generation [closed]
I'm using dgeni to extract jsDoc tags from a javascript codebase and generate markdown documentation files.
Dgeni workflow relies of the concept of pipelining. In dgeni this means that you can define ...
0
votes
0answers
8 views
Is there a way to use vuepress without a landing page?
I have a custom landing page programmed in pure HTML/CSS. I would like to add some documentation to my website and vuepress looks really promising.
My problem is that I need to use my custom HTML/CSS ...
1
vote
2answers
46 views
ocamldoc not properly displaying parameter names or description with @param
Simply put, let us say I have the following OCaml file called test.ml:
(**
[Test] is a sample module for showing the problem I am having with @ tags with OCamlDoc
*)
(**
[id] is the identity ...
0
votes
0answers
30 views
WebExtensions Experiment API schema.json to Typescript Declaration convert
I want to convert the schema.json file for my own WebExtensions Experiment API to a TypeScript Declaration file.
From this:
schema.json
[
{
"namespace": "tabsExtra",
&...
0
votes
1answer
190 views
How to generate response decriptions in FastAPI
I want to generate a description of all available responses (along with code 200 example), which are represented in the code, like here.
from typing import Any
import uvicorn
from fastapi import ...
1
vote
0answers
21 views
mdoc error for F# module: Failed to resolve type 'Microsoft.FSharp.Core.SourceConstructFlags'
mdoc-update gives an error for a reason I cannot understand, when I try to extract documentation from my F# module. I'm fairly sure that this worked a year ago with an earlier version of mono when I ...
2
votes
2answers
31 views
Setting descriptions for mojos and parameters in maven plugin
I am writing a maven plugin and I would like to add some documentation for the available goals and parameters.
When I run mvn help:describe -Dplugin=myplugin -Ddetail it prints out available goals and ...
0
votes
1answer
177 views
Doxygen EXTRACT_ALL = YES does not extract all, also undocumented warnings are still shown
I am going mad with doxygen at the moment, i hope it is not too stupid on layer 8, but we will see...
I want to extract static and undocumented stuff. That's why EXTRACT_ALL = YES for now. But ...
0
votes
3answers
31 views
How to force end of some admonitions in a RST file
I have a note in a reStructuredText formatted text that will be placed between a point of a list, and its sublist. The problem is that the note include the sublist.
Here is an extract of the file:
3. ...
0
votes
1answer
92 views
Requirement tracking Doxygen
I'm trying to generate a table of requirements covered by my tests using doxygen, I have seen this post https://stackoverflow.com/a/50827066/13269917 which works fine and generates a table that link ...
0
votes
0answers
41 views
Python and R Packages: Documentation together
I'm working on a package that has R and python versions.
For the R package I used pkgdown for documentation.
I would like to keep pkgdown because of the design and ease to use.
Which is the best way ...
0
votes
0answers
25 views
Generate REST API docs from cucumber tests
There are gems like rspec_api_documentation and others which allow you to create API docs for your application directly from working RSpec test code.
My application uses cucumber for testing, ...
0
votes
0answers
25 views
How should a Command Pattern inspired class be documented in YARD
While building a Project in Ruby I am required to document every important piece of code with RDoc, using YARD, the bulk of the work is done via Command Patterns Classes (from GOF).
The main structure ...
1
vote
0answers
12 views
Does anyone have a good solution for documenting API's generated using Views REST export displays?
I have looked into the OpenAPI module for Drupal but views is not supported from what I can see.
https://www.drupal.org/project/rest_api_doc -> Seems too old/un-maintained
2
votes
1answer
155 views
How to generate HTML documentation Deno
I heard that Deno had a built-in documentation generator using the command deno doc which I would like to run on my packages.
But it turns out it only generates JSON documentation and another tool ...
0
votes
1answer
19 views
Using Swagger to Document Methods that are NOT Endpoints
Swagger does a great job of documenting endpoints. But what if I want to auto-generate documentation for classes/class methods that are not endpoints?
Is there a way to get Swagger to do this (short ...
0
votes
0answers
31 views
How to get Jazzy to ignore Swift Packages
I'm trying to use Jazzy on a project that uses a Swift Package but it fails because of the package. Does anyone know how to get it to ignore them. I've tried a number of options, but none work.
2
votes
1answer
33 views
Make doxygen accept no-documentation for an item (but not ignore it)
When you run doxygen, you often get a lot of:
warning: some-thing-or-another is not documented.
For some items, you just want to fill in the documentation; but other are too trivial to document, or ...
0
votes
0answers
38 views
how to automatically generate a document from json file
For one of my github repositories, i want to generate documentation using readthedoc.io
in my documentation, i want certain parts of it to be updated whenever a json file is updated. basically, the ...
0
votes
0answers
78 views
API endpoints documentation in nodejs/expressjs
How can one easily and automatically generate api endpoints documentation from entity (like user) model?
I have tried swagger-ui-express and swagger-jsdoc: my problem with these two is that they are ...
0
votes
0answers
30 views
Project documentation with Ascii doc in IntelliJ
I'm documenting a Java project in an asciidoc file. I use IntelliJ as IDE.
I was wondering if there are any possibilities to reference in the documentation a class, a method or a file contained in the ...
3
votes
1answer
118 views
Tool to automatically generate documentation on elastic index
I have a project on Kibana/Elastic. I can see / manipulate the indices and see the fields and value types with GET <index>/_mapping.
Other members (in particular, managers) in my team do not ...
1
vote
0answers
12 views
Developer Documentation Builder
I am trying to build a developer documentation for my web app in the style of this: https://firebase.google.com/docs/firestore/query-data/get-data
The features I am looking for is that it has a left ...
3
votes
0answers
137 views
How to use Swagger with DTOs shared between a Nest.js API and a SPA?
I have a project with a Nest.js API and an Angular SPA. The DTOs used by the SPA to communicate with the API are in a separate project called Models and I'm using it as a dependency. In that way, I ...
1
vote
0answers
83 views
TypeDoc - “ENOENT: no such file or directory, open '…/docs/assets/css/main.css'”
I am trying to use typedoc in order to automatically generate the documentation of a angular application.
Whenever I am running npx typedoc --out docs app --exclude "**/*.{spec.ts}" --exclude ...
0
votes
1answer
127 views
Doxygen project brief not including spaces
I am developing a project and using Doxygen for the documentation. In the config file, I have put PROJECT_BRIEF = dynamic and effective, but for some weird reason on the HTML, it is appearing as ...
0
votes
0answers
19 views
Feature documentation for a feature engineering python project
I am building a python project that has a goal to be the feature engineering project (There will be 6 features that will after be used to train a model).
I was trying to think about how to make ...
0
votes
0answers
149 views
Generate documentation of existing Cordova project?
I've started working on an existing Cordova project, and I'm unfamiliar with both the codebase and the development framework. The project is not externally documented, which makes learning the ...
0
votes
1answer
232 views
How to customize the auto generated Dokka html to include a header and a footer
I'm looking for a way to customize the html generated by Dokka to include a custom header and a footer. I've previously used Doclava in order to override the template for the generated HTML and was ...
1
vote
0answers
52 views
Is it possible to add Swift documentation comments after (i.e. to the side of) a variable?
For example, instead of this:
struct MyStruct {
/// My first comment
let myVar1: Int
/// My second comment
let myVar2: Int
/// My third comment
let myVar3: Int
}
Is there a ...
1
vote
1answer
140 views
Docker volume not working with Docker-compose to generate Doxygen documentation
I'm trying to generate a Doxygen documentation in a Dockerfile using a Docker-compose to run all the services at the same time.
The goal is to generate the documentation in the container and to ...
1
vote
0answers
61 views
How to parse both the code and JSDoc comments
In order to create a documentation for a big shared project, I need to parse a JavaScript source code with an output in the JSON format (that will be transformed in other steps). My source code is ...
0
votes
1answer
23 views
NaturalDocs source code not building in VS 2015
I cannot get NaturalDocs to compile. It is unaltered code cloned from the official NaturalDocs repo (https://github.com/NaturalDocs/NaturalDocs).
I'm getting the following errors:
1>------ ...
1
vote
2answers
91 views
How do we create android application custom documentation for application flow?
Recently my team mates has started to work on an android application, which has more than 200 screens in an application.
In this case, I face one issue that when I need to explain the code or flow ...
2
votes
1answer
97 views
R object documentation: Package documentation as first item
I have an R package and I want to display the general information about the package as first item in the created PDF manual.
I use roxygen2 (version 7.0.2) for creating the documentation and ...
0
votes
1answer
41 views
Repetitive Java constructors (refactoring or generation)
Problematic
I've been making a library for a framework that I'm using in Java: I have hundreds of LOC used purely for providing many constructors to the users, but each time, with one less argument (...
1
vote
0answers
104 views
Postman/Docgen documentation doesn't show the response of endpoints
I created a node application and before it is deployed, I want to create an API documentation. For that I used postman and docgen. The created documentation works fine. It displays the endpoint, ...