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 ...
0 votes
0 answers
26 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 ...
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....
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, ...
0 votes
0 answers
48 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
76 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 ...
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 ...
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
87 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 ...
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
467 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 ...
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 ...
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> && ...