4,690 questions
Advice
0
votes
5
replies
34
views
Generating Interactive Documentation from Javascript Source Code
I’m working on an Electron project, and I can generate JSON for my code using JSDoc:
jsdoc -X > data.json
I want to use this JSON output to create a live, searchable documentation site similar to ...
- 56
0
votes
0
answers
30
views
How does the GJS documentation pipeline work with DevDocs?
I’ve noticed that GJS documentation uses DevDocs.
I’m trying to understand the documentation pipeline for GJS:
Does it read comments from the source code and generate documentation automatically?
Do ...
- 56
0
votes
0
answers
51
views
Sphinx sphinx-apidoc generated module titles are too long (full package path). How can I shorten them?
I am generating python API documentation using Sphinx and sphinx-apidoc with sphinx-rtd-theme
The problem is:
The page titles and ToC entries for modules/packages always show the full import path,
e....
- 167
0
votes
0
answers
24
views
Attach a TSDoc comment to a `export * as myModule from './my-module'`
Against ts_ls, the hover action on myModule above does not result in the documentation popping up. I've tried
/** Here is a documentation comment! */
export * as myModule from './my-module';
I've ...
1
vote
0
answers
40
views
Docsearch Typesense scraper only finds records on Docusaurus landing page
Problem
I’m using Docusaurus with Typesense and the docsearch-typesense-scraper to index my documentation site.
Everything runs fine — the sitemap is found, and the scraper produces records.
However, ...
- 11
0
votes
0
answers
49
views
How to show a single version dropdown per product in Docusaurus multi-product documentation?
I’m building documentation for multiple products on a single Docusaurus 3 website. Each product has its own versions, and I want users to be able to select a product first, then optionally select a ...
2
votes
1
answer
77
views
Why doesn’t Xcode show documentation for class initializers when creating an object in Swift?
I’m working with Swift and I’ve documented my class initializers using ///.
However, when I create an object with let obj = MyClass(...), the documentation does not appear when I Option-Click the ...
- 23
0
votes
0
answers
37
views
SAML attribute for SaaS apps
I am working with Single Sign-On (SSO) using SAML for multiple SaaS applications. Each SaaS provider requires different attribute mappings (for example: email, firstName, lastName, NameID, etc.).
I ...
- 1
0
votes
1
answer
47
views
How to generate documentation for multiple files using pydoc
I tried to generate documentation for my python project using pydoc.
My repository looks like this:
main.py
src/
├─ cli.py
├─ ui.py
In the main.py file, I have these imports:
import argparse
import ...
0
votes
1
answer
88
views
macro expand to inner attribute and inner comment
I'm trying to make some stability promises for my library. Ideally I'd like to be able to mark the top of a file as stable/unstable, and emit some things as a result.
Unstable allows unused, and is ...
- 121
0
votes
2
answers
71
views
Laravel API: PUT request with multipart/form-data returns empty request when using Swagger or Postman [duplicate]
I'm working on a Laravel 10.x project with an API that allows updating an event using a PUT /events/{id} endpoint. This endpoint accepts multipart/form-data to optionally upload an image and pdf, and ...
0
votes
0
answers
53
views
How to properly integrate cofReason and mada transaction types with Mastercard Gateway API?
I’ve been successfully integrating the Mastercard Gateway API (MPGS) using the official GitHub guide: https://github.com/scriptpapi/MPGS-Integration-Guides-and-Samples/blob/main/docs/direct.md
So far, ...
1
vote
1
answer
470
views
How to write data to a gip device (Xbox Series controller)?
I am working on a C# program that would send a power off packet to my xbox series controller in order to turn it off.
In 2024 Microsoft released GIP docs and as far as I understand Xbox One and Series ...
- 263
0
votes
1
answer
56
views
Code block partially highlighted in Sphinx
In my Sphinx documentation I have the following code-block:
.. code-block:: python
import logging
logging.getLogger('mymodule').setLevel(logging.INFO)
but when the documentation is rendered ...
- 973
3
votes
1
answer
152
views
Why add redundant `std::constructible_from<T>` to the concept `std::default_initializable`?
At the cppref page on the concept std::default_initializable, I saw the following code:
template<class T>
concept default_initializable =
std::constructible_from<T> && ...
- 44.6k
0
votes
0
answers
34
views
Can I label a method in Scaladoc and then link to its documentation?
Linking to overloaded methods is a nightmare, especially since it is typical for argument lists to have common prefixes. Ugly, bug prone, brittle, and current IDEs aren't able to process such ...
- 2,311
0
votes
1
answer
126
views
How should I document Python constants so they are reflected in Intellisense and Sphinx?
I have a file called constants.py where I store all my constants, such as paths PATH_DATASETS = "data/datasets/" or values WIDTH = 416.
They are use multiples times in the code, sometimes as ...
- 1
0
votes
1
answer
144
views
Create documentation in Backstage that is not associated with a component
I was wondering if there is some way of creating documentation in Backstage without a component. I would like to create documentation that appears in the Documentation option displayed in the sidebar ...
- 369
2
votes
1
answer
72
views
ASP.NET XML Docs with implied 'summary' tag
I want my ASP.NET (C#) project to show the XML docs comments in Swagger UI. This is working but I also want there to be an implicit <summary> tag on my comments.
E.g. I want this to work
/// ...
- 3,469
0
votes
0
answers
33
views
ToC lists subsections for Python but not for MatLab Code
I am testing Sphinx to help documenting MatLab (and Python sometimes) code using the comments. After a lot of struggling, I managed to get both working but noticed that I don't get sub-levels on the ...
- 21
3
votes
1
answer
151
views
Sphinx - autodoc imported data with own docstring
The situation
I want to use the Sphinx autodoc features to document a Python API that is implemented in the following way.
I have a module that is used to expose various symbols (functions, constants, ...
- 90
1
vote
0
answers
63
views
Inheriting constructor documentation in JSDoc with ES6 classes
I am writing documentation for some classes written using the ES6 class syntax. I have some classes which inherit their constructor from their parent class, as below:
/**
* @class
*/
class Parent {
...
- 113
0
votes
0
answers
61
views
Sphinx can't see function inside of my class when it builds
I have a project with this structure:
model_monitoring/
|-docs/
|-src/
| |-model_monitoring/
| |-class_name1/
| |-__init__.py
| |-class_name1.py
| |-class_name2/
| |-__init__.py
|...
-2
votes
1
answer
107
views
Best practice for code snippet in doc comment for C project? [closed]
I'm familiar with Rust, and recently I'm going to write a C project. In Rust, we usually embed some code snippets as usage examples directly in the doc comment. However, I found this hard to be ...
- 1,225
0
votes
0
answers
28
views
How to document input and output fields in Postman collection?
I have a Postman that I have to document, I found the document page but it seems to let me add just some descriptions.
Let's say this is a REST API service with json input, is there any way to ...
- 9,605
3
votes
0
answers
102
views
Can Doxygen generate architecture documentation from C code?
When approaching a new code, even for embedded software written in C, it is common to face a large number of big files, with no/scarce/wrong comments.
In this situation, to have a basic understanding ...
- 87
0
votes
0
answers
51
views
Doxygen hide compound reference for Namespace
The following option in the Doxyfile can be used to hide the trailing "Class Reference" text from a page title.
# If the HIDE_COMPOUND_REFERENCE tag is set to NO (default) then Doxygen will
#...
- 61
0
votes
1
answer
215
views
How to replace the deprecated plugin function with the apply function in Gradle
The Android Studio's Empty Activity default configuration calls the plugin function in two places:
in the FirstEmpty/build.gradle.kts script:
import org.gradle.kotlin.dsl.support....
- 3
-1
votes
1
answer
99
views
Google Vision AI does not include correct documentation [closed]
I am using the following code to do OCR using Google Vision AI:
from google.cloud import vision
client = vision.ImageAnnotatorClient()
bindata = base64.b64decode(b64data) # b64data is a Base64 ...
- 33.8k
0
votes
0
answers
42
views
Is there a way to generate 'File List' in Sphinx for Python?
Is there a way to generate "File lists" in Sphinx documentation for a Python repository similar to Doxygen File lists generated for C++ as shown below?
Doxygen File lists
I've tried the '...
- 1
2
votes
2
answers
593
views
How do I use CLion TIP comment style documentation?
When I was learning C++ using JetBrains CLion IDE, I noticed there are comments in the code that looks different from Ctrl + / comments. Those comments have a pen and book gutter icon (documentation).
...
0
votes
0
answers
98
views
YARD documentation in RBS
Background
I have some methods i added to String programmatically and I want to document those for code completion and generated docs. I started with just YARD’s @!method and wanted to write also type ...
- 26.5k
1
vote
1
answer
93
views
Sphinx "only" directive with lists?
When using reStructuredText in Sphinx, how can I have optional list items using the only directive?
As an example:
foo bar:
- a
- b
.. only:: Internal
- c
- d
The problem with above is that it ...
- 782
0
votes
0
answers
31
views
Show function definition on class page and topic page
Is is possible to set up Doxygen so that the detailed function definition blocks are shown on both class and topic pages?
Say I had the following class, with Doxygen comments above the method foo(). ...
- 61
1
vote
0
answers
78
views
Doxygen link to Topics page
How does one link to an auto-generated Doxygen page such as Topics or Namespaces? Typically, I would link to a page by defining its anchor and then using \ref as described here, but this is not ...
- 61
0
votes
0
answers
24
views
How to incorporate XML comment-based API documentation into GitHub?
If I have a public GitHub repo hosting .NET Core libraries, is there an easy way to integrate the documentation from the XML comments in GitHub?
I use SandCastle Help File Builder and in the past, I ...
- 10.8k
2
votes
0
answers
52
views
How to get sphinx to autodoc "items" attribute in TypedDict?
I have a custom type defined as follows:
custom_type.py
from typing import TypedDict
class CustomDict(TypedDict):
"""A custom type definition"""
items: list[...
- 21
-1
votes
1
answer
41
views
Insufficient information about jStat functions in the documentation
While writing a JS application for performing a pairwise Tukey test, I encountered an issue with the function jStat.ttest()
I described my experience below.
However, in addition I would very much like ...
0
votes
0
answers
45
views
Documentation generated from source files in a version controlled system
My current situation is that I would like to generate an html based documentation reference based on comments inside sources. To my knowledge there is no ready-made sphinx plugin for the specific ...
- 683
8
votes
3
answers
2k
views
Task ijDownloadSources not found in project app
I can't download documentation for most of all classes.
For example:
I'm using class ActivityResultContracts and when I move cursor on class name or on method in this class name, i see pop-up window ...
- 183
2
votes
0
answers
42
views
How work the limited parallelism in node.js
I'm reading the node.js documentation, and I don't understand the explanation of the asynchronous flow: https://nodejs.org/en/learn/asynchronous-work/asynchronous-flow-control.
Indeed, the last ...
- 121
1
vote
0
answers
42
views
repository with Multiple adrs
We currently work on job that stretches out over month. Every time I look at the code, I see a lot of code and in don’t remember what decision lead to that code.
there is a solution for that problem ...
1
vote
1
answer
71
views
C# XML documentation: dealing with the entirety
In recent times I annotated my entire large C# project with XML documentation, and I also made heavy use of the inheritdoc notation (for example when we are overriding a base class method).
Imagine my ...
- 333
0
votes
0
answers
59
views
Python Spyder IDE - How do view the docstring for a method in the REPL?
Currently I am going through a course and am learning about Spyder and the interface. I downloaded Anaconda and am using Spyder 6.0.1 with Python 3.12.
The text book was going through a section on how ...
- 311
1
vote
1
answer
334
views
Use of `--upgrade` option in DBT 1.7 - `dbt deps` for package-lock.yml
I am trying to understand the introduction of package-lock.yml in the DBT Documentation for Upgrading to 1.7
However, it is not quite clear how --upgrade option works.
It seems to work the same ...
- 529
1
vote
0
answers
42
views
Swagger API documentation, define array in url
Following the documentation of Swagger I've been able to document most of my API. The one I'm stuck on seems to be an array in the GET url.
What this generates is:
http://localhost/[some_url]/?users=...
- 1,131
1
vote
1
answer
118
views
How to receive Enum as String in a Dotnet API?
I have a dotnet API application documented with swagger. In one of my end-points I receive a DTO like this:
public class CreateCooperativeUserDTO
{
[Required]
public required string Name { ...
0
votes
0
answers
104
views
.NET / C#: How to ignore GenerateDocumentationFile for source generated .g.cs files by packages
My .csproj file uses
<GenerateDocumentationFile>true</GenerateDocumentationFile>
to indicate that we will be auto-generating documentation.
A given package I use creates loads of code ...
- 125
0
votes
1
answer
60
views
How to format Jenkins shared library docs
I have successfull build a Jenkins Shared library.
In the vars folder are
lbrCall.groovy
lbrCall.txt
I am missing something on formatting the documenatation of the lbrCall.txt.
The documentation in ...
- 664
0
votes
1
answer
90
views
Show length in Azure APIM Developer Portal
As it can be observed in the below image, there are only four columns visible for the request in the Azure APIM's Developer Portal, even though the max length and min length exists in the Open API ...
- 2,641