Questions tagged [code-documentation]
Documentation that focuses on code itself, such as its function, correct use, expected output, relationship to other code as well as database and tables connections, and usage examples.
379
questions
0
votes
0
answers
26
views
Where is the git documentation that specifies that a reset can take a branch name as an argument?
I've scanned the documentation here and I see no mention of how to reset to a branch's latest commit. I only see [<commit>] used but sure enough, you can specifiy 'origin/develop' in git reset --...
0
votes
1
answer
30
views
Suggestions for contributing to Documentation
Big fan of this project and hoping to contribute to the documentation. This is something I would like to do quite a bit of over the course of the next year or two. Wondering if someone might suggest ...
0
votes
1
answer
209
views
How should data be formatted to train the Huggingface DPR model?
I am new to machine learning, so maybe I have completely overlooked something, but I am trying to finetune the DPR models from the Huggingface transformers model using a dataset I am building (https://...
0
votes
1
answer
109
views
Why is the PDF generation using make.bat generated by Doxygen (LateX, refman.tex) on Windows not working?
I'm trying to generate LateX based code documentation using doxygen and using the make.bat created by doxygen to generate from LateX (refman.tex) a PDF.
Installations:
Operating System: Windows
...
0
votes
1
answer
36
views
The getter 'size' isn't defined for the type 'TaskData'
This is one of the cases that makes it is difficult to learn flutter.
Here is an example directly from (code source):
import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
...
2
votes
1
answer
39
views
Rust-like comment compilation for kotlin/java?
in short, rust compiler can compile certain code in comments, such as example code, against the actual code - resulting in always up to date commentary.
Anyone aware of any sort-of-equivalent for ...
2
votes
1
answer
147
views
Altair documentation example not working due to a Javascript Error
The following code block comes entirely from Altair documentation, it's one of the example graphs.
import altair as alt
from vega_datasets import data
source = data.population.url
select_year = alt....
0
votes
1
answer
37
views
What does Kotlin coroutines documentation mean when they say joinAll() is semantically equivalent to calling join() in sequence?
In https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines/join-all.html it's stated that "This method is semantically equivalent to joining all given jobs one by ...
0
votes
1
answer
83
views
How do I refer specifically to "this" instance of a class instead of another instance which is one of the parameters of the method?
I wasn't sure if this question should go here or somewhere else.
I'm trying to document my C++ code but I'm having trouble describing things without being verbose.
So let's say I have a class Number
...
0
votes
1
answer
396
views
Pyomo, how to make a constraint with two decision variables from two different Set()
I have an Abstract Pyomo optimization problem where I have two decision variables that are defined in two separate Set().
These are named model.BATTERY and model.HYDROGEN.
The constraint that I want ...
0
votes
0
answers
26
views
How come when I hover over an ES6 class/class method in VSCode, I don't see the JSDoc comments until I open the file containing the JSDoc comments?
I noticed with a lot of ES6 classes I created, the class itself and methods aren't always displaying the JSDoc comments on hover. I noticed that once I CTRL-SHIFT-F search the class and find the file ...
0
votes
1
answer
46
views
How can I inherit the docstring of the class in my constructor
I have a class to generate test data that I have documented with a docstring.
/// <summary>
/// In this scenario the user is new to the group, but may have existed from before.
/// </summary&...
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 ...
4
votes
1
answer
212
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 ...
0
votes
0
answers
11
views
Where can I find some fetch documentation on autogenerated content-type? [duplicate]
If I write some code to do a fetch for some multipart/form-data which looks like:
const authorization = btoa('AAAAA:BBBBB')
const data = new FormData()
data.append('grant_type', 'password')
data....
0
votes
0
answers
13
views
Javadoc - Which keyword/tag should I use for boundary cases
In large and complex project, I love to keep my code well-documented, inside and outside the code itself.
In a specific context, I have a core function that handle the whole behavior of a precise flow....
0
votes
1
answer
142
views
JSDoc object with value props as key
I have an items object with Items like this:
class Item {
/**
*@type {number}
*/
id;
}
let items = {};
I want to document the fact that keys of items is value.id is there a way ot ...
1
vote
1
answer
241
views
Automatically replace the PlantUML code in an .adoc file with the corresponding PNG images
I have a big .adoc file with plantUML Diagrams in it. The main goal is to convert the .adoc from asciidoc to markdown. For that it is necessary to replace the .puml diagrams to images (png). Its ...
0
votes
0
answers
12
views
What methods are allowed for each ContentProviderOperation.Builder type?
https://developer.android.com/reference/android/content/ContentProviderOperation.Builder says
The withXXX methods can then be used to add parameters to the builder. See the specific methods to find ...
0
votes
0
answers
89
views
How to display function docstrings from parent class with inheritance order display in Sphinx
With docstrings and automodule in sphinx I can display documentation of a parent class and children methods like that:
where Compute is a method of the above class.
I saw here: Attribute docstring ...
0
votes
0
answers
222
views
Show Python method's API documentation from a URL on hover in VSCode
Is it possible to have VSCode show a Python method's online documentation upon mouse-over/hover?
For example, PyTorch API Docs are hosted online and the method hierarchy is simple to navigate. When I ...
0
votes
1
answer
333
views
JSDoc function returning a parameter of itself
I need to document a function returning conditionally one of its parameters. But JSDoc seems not to accept variables as a return value.
I tried to do something like this following the return type {1 | ...
0
votes
1
answer
31
views
Get date from datestring
I saw you do it for someone but I can't click anything and it doesn't make sense to me to do myself can someone tell me the date out of this dateString 1663099299947 and please explain so I can figure ...
0
votes
1
answer
442
views
Where have SDL2 wiki examples gone?
In this video (https://www.youtube.com/watch?v=qPHKWsZK2Jc&list=PLvv0ScY6vfd-p1gSnbQhY7vMe2rng0IL0&index=10) from about a year ago, there is example code on the SDL_CreateWindow function ...
0
votes
1
answer
44
views
JavaScript documentation issue when having functions with the same name
I am working on a JavaScript library and trying to keep it well documented.
I am structuring it in a way that I will end-up with functions for different objects, but the same name, and when adding ...
3
votes
1
answer
1k
views
webview_flutter migration V4 Doc
How do I make my current code compatible with V4 update I checked their documentation but
I couldn't follow along
final Completer<WebViewController> _controller = Completer<WebViewController&...
1
vote
1
answer
317
views
C# Documentation: refer to other property
Suppose I have this class
public sealed class Person
{
public string FirstName { get; set; }
public string LastName { get; set; }
public string DisplayName => $"{FirstName} {LastName}&...
1
vote
1
answer
365
views
Documenting APIs - /me endpoints
I have a portfolio where I display my work (mostly backend API stuff with minimal UI to interact with) and am currently documenting the APIs. What I have is a page per project along with the ...
0
votes
0
answers
94
views
A graph description language for binary streams (network packets, binary file formats)
I'm looking for a graph description language to document binary streams like network packets or binary file formats (described in code, then output as a graph).
Something in the same idea that DOT/...
2
votes
0
answers
21
views
What is the preferred way to reference another class or method from a function's documentation?
Suppose I have:
@dataclass(match_args = True)
class Foo:
# a ton of attributes
...
def update(self, **kwargs):
"""Update the Foo.
Keyword Args:
(a ton of text)
...
2
votes
0
answers
57
views
Vs Code does not show flutter quick documentations while typing code
When I started with it, I used to get these quick docs where it would for example explain what the class would do or show the different color shades alongwith their numbers but now it doesnt and Ive ...
1
vote
1
answer
862
views
In matplotlib legend how to define number of columns in horizontal legend (ncol or ncols)?
I was having a difficult time fixing the display of a legend in one matplotlib figure, and then I noticed that maybe there is an incongruence in matplotlib documentation, or I am not searching in the ...
0
votes
0
answers
59
views
How does the Angular team manage feature flags in the framework?
The Angular team uses a website to document upgrades
https://update.angular.io/
In that website, one can select how to upgrade from version to version and it displays a detailed list of steps to ...
0
votes
0
answers
495
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 ...
1
vote
1
answer
259
views
Using PostgreSQL comments as descriptions in dbt docs
We've been adding comments to the columns in postgres as column descriptions. Similarly, there are descriptions in dbt that can be written.
How would I go about writing SQL to automatically setting ...
2
votes
0
answers
78
views
How do I read or interpret the Angular ngrx documentation correctly?
I have the createAction function from ngrx.io Store... with that signature:
https://v11.ngrx.io/api/store/createAction
createAction<T extends string, C extends Creator>(type: T, config?: C | { ...
-3
votes
2
answers
484
views
What is the official status of Windows' UMS API?
Windows 7 added an API set called UMS which allowed you to reclaim threads from user mode, and implement custom scheduling logic.
Starting with Windows 11 this feature does not appear to work. This ...
7
votes
2
answers
261
views
Official recommendation / coding style guide on using multiple @throws tags for the same exception in JavaDoc
I just recently found out that one can use multiple @throws tags for the same exception in Javadoc.
One of my students used it to document one of his methods in Connect Four:
/*
* ...
* @throws ...
1
vote
0
answers
246
views
R Roxygen2 documentation without building a package
I am currently programming within an R project. Right now there is no need for building a whole package, but I would like to use roxygen to create documentation of several functions nonetheless.
...
-1
votes
1
answer
84
views
Where to find the documentation for frappe on the github repo?
I'm on the frappe github repo and I need to find the folder that contains the documentation to contribute to it. A link to it would be super helpful .
2
votes
1
answer
321
views
How to make Python help() function work well with decorators?
Python has the nice help() built-in that displays the doc string of an object. When I use it in the REPL passing a function in my module it nicely displays:
>>> help(mymodule.myfunction)
Help ...
1
vote
1
answer
353
views
How to test if all functions in my project are commented with <summary>
I'm using jetbrains-rider / C#.
I want to test and find out if all my functions are fully commented like
/// <summary>
/// Add a and b
/// </summary>
/// <param name=&...
0
votes
1
answer
485
views
Instaloader - receive media count for inputted hashtag
I'm looking to simply input a series of hashtags and be outputted with those hashtags and their associated post count.
I believe I can use the mediacount property:
"The count of all media ...
0
votes
1
answer
245
views
How can the following: "axes.yaxis.set_major_formatter(FuncFormatter(f))" work since yaxis should be an attribute of AXIS and not of AXES objects?
Practicing on visualization as a Python newbie I have encountered this conceptual issue that got me thinking,
Infact I managed to change the price format on the y axis of a boxplot , from scientific ...
0
votes
1
answer
440
views
How many BNF-like grammar specifications does Python have?
There are at least 3 grammar-like specifications within the Python 3.9.1 reference documents 'library-3.9.1.pdf' and 'reference-3.9.1.pdf' (aka https://docs.python.org/3.9/library/ast.html and https://...
0
votes
0
answers
132
views
What exactly does Google Maps JavaScript API 3 StreetViewPanoramaOptions disableDoubleClickZoom do?
The documentation for Google Maps StreetViewPanoramaOptions lists disableDoubleClickZoom as an option.
I am using API version 3.48. I have researched and tried a bunch of different options on a ...
2
votes
2
answers
343
views
How to document LWC Salesforce components public variables with JSDoc?
JSDoc skips my public LWC variables.
Here is an example:
/**
* SomePublicVarName mode - default is false.
*
* @type {boolean}
*/
@api
somePublicVarName = false;
If I ...
0
votes
1
answer
424
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
2
answers
364
views
Canon ccapi contents` returns 100 images only
I am using Canon ccapi to download the last image taken. I am trying to find it by getting the list of all the photos from contents request and then download the last one
http://<camera-ip>:8080/...
0
votes
1
answer
517
views
What does vertical bar | mean in php documentation? [duplicate]
The php docs page on htmlspecialchars mentions:
The default is ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401.
My knowledge of | in programming documentations is only this MDN explanation of its use in ...