Top "Code-documentation" questions

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.

JSDoc: Return object structure

How can I tell JSDoc about the structure of an object that is returned. I have found the @return {{field1: …

javascript documentation-generation jsdoc code-documentation jsdoc3
Documenting Node.js projects

I'm currently using JSDoc Toolkit to document my code, but it doesn't quite fit - namely, it seem to struggle …

documentation node.js code-documentation
What do the three arrow (">>>") signs mean?

So this is probably a dumb question, but I have now been searching for quite some time, and I haven't …

python syntax command-prompt code-documentation
codestyle; put javadoc before or after annotation?

I know that it isn't the most vital of issues, but I just realised that I can put the javadoc …

java coding-style annotations javadoc code-documentation
How to document a string type in jsdoc with limited possible values

I am having a function that accepts one string parameter. This parameter can have only one of a few defined …

google-closure-compiler google-closure jsdoc code-documentation
What Are Best Practices For Documenting C# code with XML comments?

I'm going through some new code I just wrote and adding NDoc sytle comments to my classes and methods. I'm …

c# code-documentation ndoc
opencv python documentation

Recently, I want to use the OpenCV library in Python, but the documentation of Python binding of OpenCV is very …

python opencv documentation code-documentation
Is there a consensus what should be documented in the classes and __init__ docstrings?

I did not find any best practice about what should be documented in the classes and __init__ docstrings. Sometimes I …

python docstring code-documentation
How to write documentation comments in ANSI C?

I can't find how to write comments in C. I mean I know about // and /* */, what I mean is where …

c documentation code-documentation
How to create a comment to an oracle database view

I would really like to create a comment to a view with a short description of its purpose. Unfortunately it …

oracle views code-documentation