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.
349
questions
-3
votes
2
answers
76
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
83
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 ...
0
votes
0
answers
13
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
0
answers
25
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
72
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
43
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
83
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
0
answers
10
views
what does the return value nfeval represent in the DEoptim R package?
I would like to know what nfeval returned by DEoptim R package represents.
The documentation simply states nfeval: number of function evaluations.
I assumed this meant "number of times the ...
0
votes
0
answers
11
views
Can I put a Python editor in API documentation
I was working on API documentation and thought it would be really cool if people could demo their code within our API documentation. Setting up an IDE is a real barrier to entry.
W3schools has a great ...
0
votes
1
answer
50
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
80
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
63
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 ...
0
votes
0
answers
152
views
Angular Storybook with services, pipes etc
I use Storybook to get an automatically created component documentation for my angular app. However, it would also be helpful for me to see all the services, pipes and other Angular artefacts.
With ...
2
votes
2
answers
97
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
82
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
1
answer
43
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
78
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 ...
0
votes
0
answers
33
views
Pycharm: Code documentation differs between seemingly equal installations
A colleague of mine and I edit code from the same repository. Its a Python application using psycopg2 as a database driver to speak to PostgreSQL clusters. We are both decently new at this, so good ...
0
votes
0
answers
34
views
How to document class that has same name in another package?
In Java, one can have classes that can share the same name but belong to different packages altogether. However what is the best way to inform the user that this class belongs to a particular package?
...
0
votes
2
answers
40
views
How do I submit an issue in Python dev docs
I thought I noticed an error at:
https://devguide.python.org/compiler/
I poked around the devguide and found bugs.python.org, but it was not immediately clear how to highlight a quick item without ...
0
votes
0
answers
107
views
Documenting a Side Effect in a Function Using reST Style Docstrings
I've been using reST style docstrings for a while, but I was browsing through the sphinx docs again to refresh my memory and realized that I'm not quite sure if there's a "standardized" way ...
0
votes
2
answers
50
views
Is it possible to make a git diff that results in no changes?
So this is probably a silly idea, and there are probably workarounds/other solutions to this. I am curious about these, but also curious about the specific answer to the following question.
Is it ...
0
votes
1
answer
235
views
How to link a line of code from a typescript file to a markdown README.md file
I'm documenting this api, and I came across one file containing a lot of calls to another service. While writing a detailed documentation for each function, I struggled to link the specific line of ...
0
votes
1
answer
78
views
What is the programmer-friendly name for "this->that"? [closed]
Ever have a brain fart while writing up documentation and not recalling what the programmer-friendly name of something is? Well, it is happening to me.
What so we call the "SSL *s" and the &...
4
votes
3
answers
141
views
Docstrings Python Function when parameters are package objects like Pandas DataFrame
i want to know how documentation a python function when one of parameters is a object of package for example a pandas DataFrame.
i use this method but PyCharm(python IDE) doesn't understand it.
def ...
1
vote
1
answer
59
views
What have they used to write their API documentation?
I was wondering what application/service have those guys used to write their documentation? I'm especially interested in that playground section in the right side.
https://docs.nftport.xyz/docs/...
1
vote
0
answers
512
views
sphinx documentation not getting docstrings/modules
Hej! :)
I want to create a documentation of my django project and using sphinx. I wrote docstring to every function and class which I want to be integrated automatically.
I followed this tutorial and ...
1
vote
1
answer
162
views
Documentation for Firebase Remote Config *Client* API?
I'm looking for documentation detailing the API that allows clients to connect to Firebase Remote Config. I'm making a Unity project for a platform other than mobile, and I've built my own client code ...
0
votes
0
answers
77
views
Advanced Examples for pandas.DataFrame.to_latex and/or pandas.io.formats.style.Styler.to_latex()?
Do you know where I can find advanced examples of pandas.DataFrame.to_latex and/or pandas.io.formats.style.Styler.to_latex()?
By advanced I mean a table with multicols and multirows.
(I hope this type ...
1
vote
0
answers
49
views
Shell help text syntax for repeatable group of arguments
I'm writing a help output for a Bash script. Currently it looks like this:
dl [m|r]… (<file>|<URL> [m|r|<index>]…)…
The meaning that I'm trying to convey (and elsewhere describe ...
0
votes
0
answers
25
views
NaturalDoc problem while generating documentation for VBA module
I hope you're doing well
I am working with NaturalDoc version 2.1.1, to generate documentation for VBA Module
The problem is when I use accented character in VBA comments, the result is some wierd ...
0
votes
0
answers
50
views
How to create versioned documentation from AWS CodeCommit (similar to "Read the Docs" from GitHub)
I am using AWS CodeCommit. Is there any documentation tool that integrates with CodeCommit the way that "Read the Docs" (https://docs.readthedocs.io/en/stable/index.html#) can be connected ...
0
votes
0
answers
37
views
What to call non-underscore methods?
The python community has a nice name for "dunder" methods like __add__, and I've occasionally heard the term "sunder method" used to describe "suggested-private" class ...
2
votes
1
answer
98
views
What is the best way to resolve merge conflicts in .swm files?
When trying to rebase my feature branch on the base branch (dev), I got merge conflicts on swm and generated md files:
The conflicts themselves are hard to understand on their own, and include many ...
0
votes
0
answers
50
views
Handling monospaced fonts with Asciidoctor
After processing the file
= Monospaced Fonts
monospace `constrained` & ``un``constrained
with (the Ruby version of) asciidoctor and pandoc
> asciidoctor testfile.adoc
> pandoc testfile....
1
vote
0
answers
38
views
Javascript documentation is vague in VS Code, is there a plugin to show more?
Excuse my naïvety, but I find Flutter/Dart documentation very intuitive and easy to use in VS Code. Same goes for Android Studio when I was using it. Now using VS Code for javascript and Parse Cloud ...
10
votes
2
answers
233
views
How to get a "help" functionality in REPL
When I use REPL, I sometimes need to look up how a function functions e.g. splice. I usually go to the documentation website. But I don't always have internet and it'd be good if I could write help(&...
1
vote
1
answer
272
views
Mixing code documentation with code by appending various notes to sections?
Consider the following minimal example:
docs/index.rst
* :ref:`modindex`
docs/modules.rst
exampleproject
==============
.. toctree::
:maxdepth: 4
exampleproject
.. ...
-2
votes
2
answers
117
views
Documenting Unit tests in Go [closed]
Whoever writes unit tests in Go, how are you documenting them?
Is there some kind of 'docstring' (like in Python) convention?
If so, how do you maintain this documentation afterwards?
Is it possible ...
1
vote
2
answers
567
views
How do you document a Rust struct/enum in one documentation block before the struct?
How do you document a Rust struct or enum in one documentation block before the type, so as to avoid polluting the contents with confusing mess?
This is what I do at the moment, which is really ...
1
vote
1
answer
278
views
Spacy 3.1 example code for Transformers in the online documentation seems to be wrong
In the latest documentation for Spacy, the following example is given at the following link:
https://spacy.io/usage/embeddings-transformers
import spacy
from spacy.tokens import Doc
from ...
1
vote
0
answers
40
views
How do you connect an application to Zoom?
I am looking for a way to create an app for an application I already have developed, and use it on Zoom.
So for example: I have a software application on my desktop that uses a GUI to communicate with ...
1
vote
0
answers
40
views
Python 3: Managing keyword arguments hierarchy
I am working on python 3, with some methods that are nested.
These shares keyword arguments something like below.
def fun_A(a, **kwargs):
...
fun_B(**kwargs)
...
def fun_B(b, **kwargs):
...
2
votes
1
answer
64
views
How does the swimm verify command scope change?
I'm part of the beta using Swimm for documentation and have created some documents with coupled code snippets. I'm able to verify that the documents have up to date snippets using the swimm verify ...
0
votes
0
answers
31
views
Flutter documentation in Android Studio
I've recently updated Android Studio for Flutter development, and a documentation formatting issue has popped up.
Previously, the documentation would vertically list all the properties for the Flutter ...
0
votes
0
answers
71
views
R package examples with external files
I have developed a R package with many functions that use external files as a parameter. I am documenting the package with examples and when I run the devtools::check() command I get an error because ...
-1
votes
1
answer
172
views
Effectively using the docs to find all standard library functions that take an io.Reader as an argument
I have a question about how to find information in the Go docs.
I saw that net/http Response.Body is a value of io.ReadCloser.
go doc io readcloser lead to go doc io reader, but that was a deadend. I ...
-1
votes
1
answer
167
views
Documentation for C# Project Property: `<Features>strict</Features>`
I want to develop C# with all possible warnings from Microsoft turned on, and I found this answer that says to add <Features>strict</Features> to my .csproj file.
However, before I start ...
2
votes
1
answer
85
views
Microsoft documentation for a typical Excel 365 object refers to "an object in the Applies To list", but where is the "Applies to list"?
I think my Question's title clearly expresses the essence of the information I need. I Googled where is the "applies to list" in vba excel and a few variations of that, all with quotes as ...
0
votes
0
answers
157
views
Python imaplib documentation
I'm looking into the python imaplib library and starting testing things. I looked in the documentation and
read that get_payload() is deprecated and you have to use get_body().
When I look at my ...