Function comments #18

Open
opened 7 years ago by pandro · 1 comments
pandro commented 7 years ago
Collaborator

There should be basic doc strings for important, especially exported, functions.
Otherwise we might loose overview rather quickly.

Also the general idea of a file (e.g. 'what is in command.js') should be noted roughly.

There should be basic doc strings for important, especially exported, functions. Otherwise we might loose overview rather quickly. Also the general idea of a file (e.g. 'what is in command.js') should be noted roughly.
pandro added the
Enhancement
label 7 years ago
lub commented 7 years ago
Owner

Maybe it is worth to look into JSDoc? It is also used by matris-js-sdk.

You make your comments in the code (where they belong) including tags if needed and afterwards you can also build a documentation out of it, which provides probably a better overview than the comments in the code itself.

Also see http://usejsdoc.org/about-getting-started.html for examples

Maybe it is worth to look into [JSDoc](http://usejsdoc.org/)? It is also used by matris-js-sdk. You make your comments in the code (where they belong) including tags if needed and afterwards you can also build a documentation out of it, which provides probably a better overview than the comments in the code itself. Also see http://usejsdoc.org/about-getting-started.html for examples
This repo is archived. You cannot comment on issues.
No Milestone
No Assignees
2 Participants
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

Dependencies

No dependencies set.

Reference: lubiland/heimdall#18
Loading…
There is no content yet.