search

tspoff / token-playground

1 stars 2 forks source link

Add Code Comments and Code Documentation Project-Wide #4

Open jordanmack opened 4 years ago

jordanmack commented 4 years ago

Add code comments and code documentation project-wide. Using a documentation tool like TSDoc or TypeDoc is recommended. We will find a place to publish the code documentation at a later time (probably GitHub pages).

tspoff commented 4 years ago

Do you have a recommendation on which tool to use? I haven't used either in the past. The microsoft standard shown w/ TSDoc seems like a good approach, so I'll probably go with that unless you think there's a better way.

jordanmack commented 4 years ago

In the past, I've used stuff like JSDoc, but I can't recommend that for TypeScript. Different solutions need to be investigated, and we should try to encourage all Nervos developers to follow the same recommendation.

The ideal solution:

TSDoc is probably the best bet, but alternatives should be looked at to be sure.