> -----Original Message----- > From: [EMAIL PROTECTED] > [mailto:[EMAIL PROTECTED] On Behalf Of > Rutger Dijkstra > Sent: zondag 21 november 2004 12:31 > To: [EMAIL PROTECTED] > Subject: Re: [Nant-users] Content of distributions ? > > Ian, > > I completely disagree with the proposition that the SDK-docs > would serve no > purpose for end-users. > > The *extensibility* of NAnt is definitely end-user > functionality; of all the > things that NAnt has going for it, it is one of the bigger > ones. It should > be > possible to create your own tasks, types, and functions using > no more than > the > binaries and their documentation. > > In fact, this is true for anything you make that you expect > others to use: > requiring the users of your stuff to reverse-engineer the > manual from source > is > inconsiderate an unprofessional. > > I am responsible for the introduction of NAnt in a biggish > enterprise and > the > vast amount of red 'Missing <summary> documentation ...' is > for me both > embarrassing and worrying. It is embarrassing because it > challenges the > wisdom > of my choice; I can only apologize to my co-workers and > defend NAnt is an > "otherwise highly professional" tool. It is worrying because > it strikes me > as a > "broken window": if something is not done about it asap, it > will rapidly get > worse. > > I'd really hate to see NAnt loose out to MSBuild for no other > reason than > amateurish carelessness with the documentation.
Would it be ok for you if the SDK docs are part of the source distributions, and perhaps also available online ? I agree that documentation is extremely important, and this is something we need to make a priority for the next releases. We can use all the help we can get, so if there's anything you can contribute .... Gert ------------------------------------------------------- SF email is sponsored by - The IT Product Guide Read honest & candid reviews on hundreds of IT Products from real users. Discover which products truly live up to the hype. Start reading now. http://productguide.itmanagersjournal.com/ _______________________________________________ Nant-users mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/nant-users
