2 ms·
A framework without documentation, is not a framework at all. The article spends a bit of time on this, but I believe it's worth reiterating. The reason for usi
by joesmo 13y ago
A framework without documentation, is not a framework at all. The article spends a bit of time on this, but I believe it's worth reiterating. The reason for using a framework is to not have to rewrite common functionality. Without good, complete documentation (both in code and external to the framework) one cannot even evaluate a framework in a timely manner.
While doc-blocks and comments are crucial to all code, and especially crucial to framework code, a framework that relies solely on auto-generated documentation is one without complete documentation. There is more to documentation and the coherency of a framework and its use cases than describing its microscopic parts.
- collyw 13y agoAngular documentation is awful, and its one of the most popular out there.