----- Original Message ----- From: "Rutger Dijkstra" <[EMAIL PROTECTED]> To: "Gert Driesen" <[EMAIL PROTECTED]>; <[EMAIL PROTECTED]> Sent: Tuesday, November 23, 2004 12:41 PM Subject: RE: [Nant-users] Content of distributions ?
> Gert, > > Not distributing the SDK with the 'production distributions' (= > binary) fails to do justice to one of the most marvelous features of > the architecture of NAnt: it's extensibility. > > If you are going to include the SDK in the source distributions > only, why bother with dynamic discovery of tasks, reflection, etc? > Would it not be far easier to simply hack you extensions into the > original sources and recompile? I understand your concern, and I appreciate your feedback. > One can, of course, distribute the relevant documentation by making > it available online; this is a respectable thing to do. However, > that would mean that you have to ensure the continued availability > of the documentation of older versions of NAnt: people my still be > relying on it. I am working on this, and I've already done this for the user manual. Doing the same for the SDK will not take much effort. > This would require a far better than current > organization of the continued availability of previous > distributions. Same here : I'm already looking into this, and have posted a message on this topic to the users mailing list (I think, might have been developers mailing list). > > The easiest way to ensure that users of version X also have access > to the documentation of version X is, obviously, to package the docs > in the distribution. Sure, but I'll make the docs available online (too) anyway ... > cheers, Rutger > > PS. where does the idea of removing the SDK from the binary > distributions actually come from? Would it serve any purpose? It increases the size of the distributions, and not that many "normal" users actually have interest in the SDK docs. The increased size of the distribution is not really a problem for the officicial releases, but uploading the nightly builds takes about 30 minutes (during which my dev pc is not usable, as scp makes my pc unresponsive). Surely this cannot be a reason to stop including SDK docs in official releases ... That's why I sent a message to both the dev and user mailing lists to find out what the NAnt community thinks about removing the sdk docs from the binary distributions. And by looking at your response, it might be best to retain the SDK docs for the binary distributions too. I'll modify our packaging later ... > PPS. I would't mind contributing to the documentation effort, but, > not having written the software, my documentation could only be > my best guess. It might be better if the documentation is written > by the people that actually know. Sure, but we don't have a lot of time (I do have a day-time job and a girlfriend, not to forget). So we would definitely welcome your contributions, and correct them where necessary. 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
