On 9/18/2012 11:58 AM, Gregory Szorc wrote:
grep is not a suitable discovery mechanism for casual developers. What
they want is a categorized list. Something like [1]. And, this should
be easily accessible. |make documentation| doesn't count because it
requires obtaining a source tree. We should be lowering the barrier to
entry, not increasing it. i.e. we shouldn't require people to download
or build the source to develop extensions.
If you take, for example, the clang codebase, they automatically update
doxygen documentation every day and put it on the web at
<http://clang.llvm.org/doxygen/>. I was pointing out that we currently
have a mechanism to generate documentation (but with lots of asterisks
about how it's not really a solution at this point).
_______________________________________________
dev-platform mailing list
dev-platform@lists.mozilla.org
https://lists.mozilla.org/listinfo/dev-platform
