Re: Documentation
- From: Arnold Snarb <snarb@xxxxxxxxxxxxxxxxxxxx>
- Date: 28 Apr 2008 18:21:28 GMT
On 2008-04-28, vitic <vitick@xxxxxxxxx> wrote:
I propose to BAN all extensions included with Tcl distribution that do
not have detailed documentation plus understandable examples of usage.
It is amazing that in many packages the provided usage SYNTAX passes
for documentation.
Many of the packages sit there for years and nobody uses them. What up
with the authors? They spent much of their time creating the package
but are LAZY to provide examples of usage? Their work has been
WAISTED. Including wasted hours of users who try to figure out how the
package works.
Or, somebody, please write a book that documents all the packages
included with the distribution.
No, no, no! Other way around! We must INCLUDE all of those
extensions IN THE CORE!
The Tcl core is well-documented. If we [*] put all the
badly-documented extensions in the core, then they'll become
well-documented too [**].
[*] and by "we", I mean "somebody else".
[**] the MAGIC DOCUMENTATION FAIRIES will take care of this part.
--AS
.
- Follow-Ups:
- Re: Documentation
- From: Donal K. Fellows
- Re: Documentation
- References:
- Documentation
- From: vitic
- Documentation
- Prev by Date: Re: Documentation
- Next by Date: Re: Call flow - tcl - menu ivr - array as fsm? better than if?
- Previous by thread: Re: Documentation
- Next by thread: Re: Documentation
- Index(es):
Relevant Pages
|
