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.

Filter by
Sorted by
Tagged with
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 --...
IEnjoyEatingVegetables's user avatar
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 ...
Drew Hamilton's user avatar
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://...
Pididle's user avatar
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 ...
Iris's user avatar
  • 1
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'; ...
user8016440's user avatar
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 ...
MomStopFlashing's user avatar
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....
RavenbornJB's user avatar
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 ...
fness's user avatar
  • 89
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 ...
trialdaniel1829's user avatar
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 ...
Casentive's user avatar
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 ...
JwJamison's user avatar
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&...
Stian Jørgensrud's user avatar
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
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 ...
Greg's user avatar
  • 3,046
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....
Eric G's user avatar
  • 401
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....
Bugpirasi's user avatar
  • 381
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 ...
Fiodar Shurankou's user avatar
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 ...
emotionalDamage's user avatar
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 ...
Richard Parkins's user avatar
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 ...
Jejouze's user avatar
  • 23
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 ...
Austin's user avatar
  • 8,088
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 | ...
Fiodar Shurankou's user avatar
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 ...
Dani's user avatar
  • 1
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 ...
user486185's user avatar
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 ...
Oliver Rodrigues's user avatar
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&...
zakiblacki's user avatar
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}&...
Wouter Vandenputte's user avatar
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 ...
Tom687's user avatar
  • 192
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/...
randruc's user avatar
  • 11
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) ...
Chris's user avatar
  • 29.3k
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 ...
Syed Abdullah's user avatar
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 ...
MrT77's user avatar
  • 841
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 ...
Juan Stoppa's user avatar
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 ...
psw's user avatar
  • 45
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 ...
Mark's user avatar
  • 105
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 | { ...
MMMM's user avatar
  • 3,360
-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 ...
Badasahog's user avatar
  • 589
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 ...
Markus Weninger's user avatar
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. ...
KidLu's user avatar
  • 163
-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 .
Preshh0's user avatar
  • 19
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 ...
neves's user avatar
  • 34.5k
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=&...
K--'s user avatar
  • 669
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 ...
Kal-Toh's user avatar
  • 77
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 ...
Leonardo Melia's user avatar
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://...
berniethejet's user avatar
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 ...
coderfin's user avatar
  • 1,708
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 ...
Florian G's user avatar
  • 567
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 ...
John's user avatar
  • 901
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/...
Serob_b's user avatar
  • 985
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 ...
user31782's user avatar
  • 7,187

1
2 3 4 5
8