Tom MacWright
Tom MacWright
Another thing that JSDoc unfortunately leaves undocumented: how many times can you use a tag? If you use a tag more than once, which value wins? Taking a cue from...
This could be "Replace lemon juice with lime juice", given that we know that both are juice.
Overloading methods is often an anti-pattern: [monomorphism](http://mrale.ph/blog/2015/01/11/whats-up-with-monomorphism.html) has performance advantages, and often multiple functions taking different arguments are more clear than one function that accepts a variety of arguments. That...
We can / should allow people to give their own ratings to cocktails, and mark ones they've tried.
In firefox, I sometimes see the site load like this: I think this may be a Firefox bug, or an elm-ui bug.
When do comments attach to content, and when do they not attach? For instance: ```js // does this comment need to be right next to function theFunction() {} // does...
documentation.js uses Markdown. rustdoc started markdown, switched, switched back to markdown. - Markdown is super popular - But we want to differentiate links that are meant to inter-link documentation versus...
Wishlist feature: Given a set of ingredients you have, Old Fashioned should be able to suggest which additional ingredient (or 2 ingredients, or 3…) will yield the highest number of...
USE CASE: You've built a REPL or another type of JavaScript editor, and you're importing different JavaScript libraries and want to show documentation for their methods, dynamically. Right now, you...
Namepaths are [a JSDoc'ism](http://usejsdoc.org/about-namepaths.html) - a feature that documentarians use to refer to different parts of their exported API. Their examples: ``` myFunction MyConstructor MyConstructor#instanceMember MyConstructor.staticMember MyConstructor~innerMember // note that...