BT

Microsoft to Release NDoc Killer

| by Marcie Jones Follow 0 Followers on Jul 28, 2006. Estimated reading time: 1 minute |
According to an MSDN Forums post, Microsft is preparing to release a Community Tech Preview (CTP) of Sandcastle (Documentation Compiler), its answer to NDoc, the open-source generator for documentation from XML code comments.

According to Michael Primeaux, Sandcastle generates documentation using the following overall process:
  1. Use the "/doc" compiler option to generate an XML documentation file.
  2. Run the assemblies through Sandcastle (MRefBuilder, XslTransform, and BuildAssembler) to produce a set of HTML files.
  3. Generate resulting help using the Microsoft HTML Help Compiler. The help compiler version 1.0 is used to produce CHM files and version 2.0 is used to generate HXS files.
The imminent Sandcastle release has prompted NDoc author Kevin Downs to officially discontinue NDoc development and withdraw from the open source community.  In a letter to alpha testers earlier this week, Kevin also lamented the lack of code contributions to the SourceForge project, as well as a lack of financial contributions (donations) from the many users of the product, noting that "if only roughly 1-in-10 of the those who downloaded NDoc had donated the minimum allowable amount of $5 then I could have worked on NDoc 2.0 full-time and it could have been released months ago!"

Kris Cargile suggests:
The simple fact is, if financial gain is your primary goal, you probably shouldn't invest your time in an open-source project.

Rate this Article

Adoption Stage
Style

Hello stranger!

You need to Register an InfoQ account or or login to post comments. But there's so much more behind being registered.

Get the most out of the InfoQ experience.

Tell us what you think

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Email me replies to any of my messages in this thread

Selective Quoting? by George King

Obviously Kris didn't read the whole thing, or choose to ignore stuff to make a point! To put that quote in context (my emphasis added)
To put this into perspective, if only roughly 1-in-10 of the those who downloaded NDoc had donated the minimum allowable amount of $5 then I could have worked on NDoc 2.0 full-time and it could have been released months ago! Now, I am not suggesting that this should have occurred, or that anyone owes me anything for the work I have done, rather I am trying to demonstrate that if the community values open-source projects then it should do *something* to support them.

Seems fairly clear that he wasn't even asking for money, let alone it being his primary goal!

Kevin also said that the release of Sancastle was not the main reason for him quiting, he was just feed-up with all the crap he was getting.

Having read stuff like Kris's character assasination who can blame him?

Re: Selective Quoting? by Kristopher Cargile

Talk about selective quoting! Kevin cited several reasons for abandoning the NDoc project - Sandcastle and money being only two of them - and I covered each of these. But to suggest that the community should pony up an annual salary for you to work full-time on an open-source, community project is asinine. As is complaining that no one will help when you just won't let them. Kevin is missing the point.

He has every right to leave the project, no matter what the reason, and I wish him well in his pursuits. We can only hope that he'll actually hand everything over before he goes so that NDoc can live on.

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Email me replies to any of my messages in this thread

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Email me replies to any of my messages in this thread

2 Discuss
BT