Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add type info to jsdoc params #29

Closed
lipp opened this issue May 2, 2016 · 5 comments
Closed

add type info to jsdoc params #29

lipp opened this issue May 2, 2016 · 5 comments

Comments

@lipp
Copy link
Contributor

lipp commented May 2, 2016

Jsdoc params should be documented like this:

/**
 * Bla
 * @param {String} The foo in the game
 * @param {Number} [index=0] The first foo index
 * @return {String[]} All the foos as array
 */

Nice to have: add examples from Markdown to JSDoc comment

/**
 * @playground
 * var slugify = require('strman').slugify;
 * let title = "A Javascript string manipulation library.";
 * let result = slugify(title);

to get output like this:
https://doclets.io/dleitee/strman/master#dl-slugify

@dleitee
Copy link
Owner

dleitee commented May 2, 2016

Very well.
Now that this divide the functions not to generate conflict?
I will describe here which functions I'll document.

  • safeTruncate
  • truncate
  • removeEmptyStrings
  • format
  • compare
  • equal
  • inequal
  • hexEncode
  • hexDecode
  • binEncode
  • binDecode
  • decEncode
  • decDecode
  • urlEncode
  • urlDecode
  • base64Encode
  • base64Decode
  • htmlDecode
  • htmlEncode

@lipp
Copy link
Contributor Author

lipp commented May 2, 2016

ok. i'll start [a-e] from the available functions (markdown). probably have time tomorrow evening...

which is:

@dleitee dleitee mentioned this issue May 2, 2016
21 tasks
@lipp
Copy link
Contributor Author

lipp commented May 4, 2016

@dleitee First part done. Hope you like it ! #36

https://doclets.io/lipp/strman/add-to-doclets

@dleitee
Copy link
Owner

dleitee commented May 4, 2016

@lipp PR #36 merged.

@dleitee
Copy link
Owner

dleitee commented May 4, 2016

  • first
  • indexOf
  • insert
  • isLowerCase
  • isString
  • isUpperCase
  • last
  • lastIndexOf
  • leftPad
  • leftTrim
  • length
  • prepend
  • prependArray
  • removeLeft
  • removeNonWords
  • removeRight
  • removeSpaces
  • repeat
  • replace
  • reverse
  • rightPad
  • rightTrim
  • slice
  • split
  • startsWith
  • substr
  • surround
  • toCamelCase
  • toDecamelize
  • toKebabCase
  • toLowerCase
  • toSnakeCase
  • toStudlyCaps
  • toUpperCase
  • transliterate
  • trim

@dleitee dleitee closed this as completed May 11, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants