drashland / rhum

A test double library
https://drash.land/rhum
MIT License
91 stars 6 forks source link

Change JSDoc to TSDoc #30

Closed ebebbington closed 4 years ago

ebebbington commented 4 years ago

Summary

What: Convert JSDoc blocks (though we use a mix of JSDoc and Deno's standard), to TSDoc blocks in Typescript files

Why: We primarily use TypeScript so it makes sense to use TSDoc. Types are already documented in the method/property anyways.

Acceptance Criteria

Example Pseudo Code (for implementation)

* @param string filename
*        The filename to do something with

* @param filename - The filename to do something with

Resources

TSDoc is very similar, there is really only a few minor changes to make to each doc block

https://github.com/microsoft/tsdoc