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.

Filter by
Sorted by
Tagged with
-2 votes
1 answer
25 views

Any suggestion for a web site generator for documentation? [closed]

Context : I'm a new IT admin and for the team that i support i want to do a good documentation center where they can easily find what they want. What i want : I was hoping to find a github repository ...
Quentin Fourrier's user avatar
-1 votes
0 answers
16 views

Creating parametric document later to become a pdf

I have a task of creating some sort of a pipeline that would allow technical writers to make parametric documentation. Most of the text in such a document wold be the same, however, some parts of it (...
Sergei's user avatar
  • 99
1 vote
1 answer
32 views

Jazzy: zsh: no matches found: --documentation=./*.md

I'm using jazzy and it seems to not want to include all of the markdown files in the rendered documentation pages. For example, jazzy --xcodebuild-arguments -scheme,MyCustomSchemeName --documentation=...
Richard Topchii's user avatar
0 votes
0 answers
5 views

Dokka, Kotlin: How to get a DProperty's type? Or, in general, `DType` from `Bound`?

In Dokka, which is Kotlin's documentation library / toolkit, I want to get a type of a DProperty. DProprety.type gives Bound. What I need is rather some kind of type, like, DType. How can I achieve ...
Ondra Žižka's user avatar
4 votes
1 answer
644 views

Sphinx-AutoAPI Error: "'Module' object has no attribute 'doc'" with Various Sphinx Versions

I'm relatively new to using Sphinx and I've encountered an issue that I'm struggling to solve. I suspect the error might be related to the version of Sphinx I'm using, but attempts to resolve it with ...
daniel guo's user avatar
0 votes
0 answers
41 views

How to use roxygen2 to print documentation of self defined function?

I define a function called avglist in R and would like to print the documentation of avglist using ?avglist or help(avglist), but they both failed. library(roxygen2) #' Function:avglist #' #' ...
Erin Chen's user avatar
1 vote
1 answer
70 views

how can I make readthedocs find my configuration file which is already in GitHub project repository root directory?

I am trying to publish a Python package's documentation on readthedocs.org. It was being published in previous releases. However, I am getting "The configuration file required to build ...
Ceren's user avatar
  • 77
0 votes
0 answers
44 views

Why is erdantic now showing one to many / list relationships?

When using erdantic with pydantic model, the one to many relationships are not rendered properly As shown below the erdantic examples work as expected, however the simple example I have shown is not ...
Oliver Tyrrell's user avatar
0 votes
0 answers
42 views

Swig-Doxygen translation lines still appear on C++ script

I am using swig to generate wrapper Python function for C++ based application. when using swig, I am using -doxygen option to translate doxygen document to python wrapper file. Inside C++ header file, ...
Edward's user avatar
  • 1
0 votes
1 answer
66 views

What is modules.rst from sphinx-apidoc?

I am using sphinx==6.2.1 and sphinx_rtd_theme==1.3.0. I ran sphinx-apidoc, and it generated a modules.rst that looks like this: package ====== .. toctree:: :maxdepth: 4 package When I go to ...
Intrastellar Explorer's user avatar
0 votes
0 answers
87 views

Generate Python Documentation from .pyi stub

I Have a Pyo3 project written in rust where I'm generating a python package. To get IDE typings, I've created a .pyi stub, with relevant docstrings. However, I notice that the docstrings on the ...
Potatoman's user avatar
0 votes
1 answer
53 views

How to include publishing notes in Sphinx documentation?

I would like to include a link to our publishing notes in the footer of Spinx html outout, next to the Copyright notice. I tried to include a link in the copyright notice in conf.py. However, that is ...
Stefan's user avatar
  • 10.5k
0 votes
0 answers
149 views

Using React Components to Render TypeScript as Code Blocks in MDX Files

I have a documentation site using nextra. In pages are the MDX Files and in samples are next-app examples. pages course docu samples app1 app2 Now I want to render code from the samples within my ...
Jeremy Hill's user avatar
0 votes
0 answers
111 views

Difficulty Setting Up Hierarchical Sidebar On TypeDoc Generated HTML Docs Site

Typedoc has been helpful for generating a static website from inline doc comments (tsdoc standard), but it has an issue where it lists the entry points all in one column instead of grouping theme ...
Michael Sohnen's user avatar
1 vote
0 answers
84 views

Jupyther Shift-Tab not working with Pandas

Consider executing the following conde: import pandas as pd df = pd.DataFrame({'x':[1,2,3]}) Then putting the cursor inside the parenthesis of df.sort() and hitting shift-tab does not open the ...
Mansour Shams's user avatar
1 vote
0 answers
160 views

Vue component's description for vue-docgen-api in script setup

The vue-docgen-api shows an example of component description in the "old" options style: <script> import { text } from './utils' /** * This is an example of creating a reusable grid ...
Matej's user avatar
  • 145
1 vote
1 answer
76 views

Items and sub-items in different directories and listed in menu - Sphinx

I'm creating a project using the Sphinx tool. And to keep the organization, I separated the sub-items into directories with the name of the item "Mother", as follows: ├──conf.py ├──index.rst ...
Rockguitar's user avatar
0 votes
1 answer
163 views

Dokka is not generating documentation for test package

I have KDoc style comments in my tests code and I want to generate documentation using Kotlin DSL Gradle dokkaHtml tasks. But after successfully executing the task it says "Exiting Generation: ...
miluni's user avatar
  • 3
2 votes
0 answers
51 views

How to add autocomplete and documentation to a custom language?

I have built a new programming language. So far I have already completed the syntax highlighting and snippets using the Visual Studio Code documentation. Now, I need to add autocomplete and ...
Youssef Maouche's user avatar
0 votes
1 answer
243 views

How to make Typedoc grab TSDoc comments inside of a type definition

i'm working on the implementation of typedoc in my company's codebase and i'm stuck on an issue. /** * The tuples and levels corresponding to the selected positions (which can be headers in a table ...
Adam Le Roux's user avatar
2 votes
0 answers
132 views

Docstring for toml file in Python

Since 3.11, Python tomblib provides support for TOML files. I would like to know if there is a way to add docstrings to the fields in the TOML file. In particular, to be rendered with Sphinx. I am ...
JuanPi's user avatar
  • 799
0 votes
0 answers
20 views

How Python's "Changed in version" statements are generated?

I'm curios how the "Changed in version" statements are generated in Python's docs. Consider the documentation for namedtuple: Changed in version 3.1: Added support for rename. Changed in ...
algonell's user avatar
  • 129
4 votes
1 answer
213 views

Autogenerate Console Output for Roxygen @examples Section

Background I am documenting an R package, and I wish the @examples section(s) to include the (commented) output below the code, so the user need not run the examples (in the console, etc.) in order to ...
Greg's user avatar
  • 3,046
2 votes
0 answers
150 views

Sphinx usage with Matlab does not generate documentation (sphinxcontrib.matlab)

I am currently developing a MATLAB toolbox as part of my bachelors at TUM, that I would like to document using the automatic documentation in Sphinx. There is a extension available for just that here. ...
L. Merbecks's user avatar
0 votes
0 answers
85 views

Multilingual Custom Landing Pages in Sphinx

I have a sphinx generated site with the following settings in my conf.py: root_doc = 'contents' html_additional_pages = {'index': 'index.html'} This allows me to add a custom landing page in the ...
N_user's user avatar
  • 37
0 votes
1 answer
685 views

Generate documentation for python functions in a jupyter notebook using docstrings

There is a Jupyter Notebook with multiple python functions with docstrings. Is there a way to generate documentation for those functions without converting the notebook into a Python script? Usually, ...
Hiran Hasanka's user avatar
0 votes
0 answers
56 views

How to combine HTML Export files with Vue.js App?

I have a Vue.js app that I want to host using Netlify for example. Besides content from different headless content management systems, I have HTML pages (documentation) from other sources, which I ...
Bastian's user avatar
  • 11
0 votes
0 answers
25 views

Find a class instance inside a function (JS) or how to write good self-documented code

Probably everyone was facing the issue when Postman documentation will be barely up-to-date with the code currently running in dev or production. Almost every time the source of that problem is "...
Konstantin Mironov's user avatar
0 votes
1 answer
56 views

Comment a code on pycharm without pushing to git

I would like to post my own comments and understandings into a code, where I don't want these comments to be pushed to the repo. I'm not sure if this is possible, currently, I'm creating a local ...
Busy Bee's user avatar
  • 117
0 votes
0 answers
68 views

Sphinx typehinting shows full path to classes ant not links

I am currently working on a python project and want to automatically generate the documentation for my project In order to automatically generate my documentation, I do: sphinx-apidoc -f -o source ../...
Lupos's user avatar
  • 914
0 votes
1 answer
204 views

Sphinx auto-documentation doesn't work with classes which improt other classes

I am currently working on a python project and want to automatically generate the documentation for my project In order to automatically generate my documentation, I do: sphinx-apidoc -f -o source ../...
Lupos's user avatar
  • 914
0 votes
0 answers
123 views

Style not compatible with Jupyter-Book when using python-sphinx autodoc to generate API documentation

I'd love to use the so elegant Jupyter-Book to construct documentation for my packages. I've tried quite a lot, and here is an example I'm finalizing those days : the package is available on a gitlab ...
FraSchelle's user avatar
0 votes
1 answer
46 views

How to visualise nested functions in Django Admin documentation generator

I have a django project and inside my views.py file I have the following (theoretical) functions where you can see that the get_fullname() function is nested: def dataframerequest(request, pk): ...
SOK's user avatar
  • 1,732
0 votes
1 answer
122 views

Automatic documentation of api roles and permissions (django rest framework)

I have a Django project with various REST APIs. The permission to access those APIs are defined throught rest_framework permission classes and django.contrib.auth.models Permission model. The ...
Shad's user avatar
  • 11
1 vote
1 answer
414 views

Descriptions for endpoints in Swagger for Plumber API

The documentation for block annotations for Plumber endpoints in R states the following about comments without an annotation: First line without annotation will be mapped to Summary field subsequent ...
Nico Munting's user avatar
1 vote
2 answers
3k views

How to make Visual Studio 2022 documentation generation?

I'm trying to generate documentation in c++ project (VS 2022 Community) using xml-tags in comments like <summary>, <returns> and so on. I was searching project setting, configured output ...
Саша Е's user avatar
0 votes
0 answers
505 views

How do I run doxygen from command prompt to generate html files

Need to generate python code doxygen document using automatic process. while developing this need to run doxygen from command prompt, so I need windows command for that so I can run doxygen from ...
psw's user avatar
  • 45
5 votes
0 answers
169 views

Include specific lines of code from a source file in Docusaurus

I'm currently deciding whether to migrate my developer docs from Sphinx to Docusaurus. The one thing that's holding me back is that Docusaurus (and in fact Markdown in general) doesn't support pulling ...
kenna's user avatar
  • 61
0 votes
1 answer
168 views

I want to generate this table on a PDF. Any suggestions on what library to use? [closed]

This is the table: This is where the table comes from. I have also checked react-pdf but table generation is not yet implemented and it is a huge pain to create this using plain CSS.
Peter La Anguila's user avatar
3 votes
1 answer
682 views

Is is possible to generate documentation for one private function?

How can I force rustdoc documentation for one private function? In my project, there are many private functions. I do not want them to be part of the generated rustdoc output (command cargo doc). It's ...
JamesThomasMoon's user avatar
0 votes
0 answers
326 views

Documenting an Angular library

I have been writing an Angular library and wondering if you use any tools, follow any conventions while documenting it. Are there any common templates to create readme files, Gitbook or Confluence ...
Ayberk's user avatar
  • 50
0 votes
1 answer
337 views

How do you make a 'docset' that you can use for Dash app?

I have been googling this for like 2 hours now and i cannot figure it out. I want to make a docset out of the GitHub CLI Manual so i can access it locally on my mac using Dash app (or DevDocs app for ...
Devin Schumacher's user avatar
0 votes
1 answer
390 views

How to read document from another repository in docusaurus

I have created a Docusaurus app on a Github repository and I want to add some external sources to it. Those sources are one or more Github repositories from the same organisation. There is any way to ...
Stefano Caravana's user avatar
1 vote
1 answer
316 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 ...
Damon's user avatar
  • 10.6k
0 votes
0 answers
248 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 ...
einpoklum's user avatar
  • 121k
0 votes
1 answer
941 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 ...
Yusuf ElNu'man's user avatar
0 votes
1 answer
303 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 ...
jjnrmason's user avatar
  • 249
0 votes
0 answers
159 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 ...
Lizzy's user avatar
  • 39
0 votes
1 answer
431 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 ...
John's user avatar
  • 901
1 vote
0 answers
203 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 (...
Mario Mateaș's user avatar

1
2 3 4 5
17