NDoc Replacement

**Brian Richards** · Aug 29 '06, 06:15 PM

Re: NDoc Replacement

I just read about Sandcastle MS's answer to NDoc. Unless anyone knows of any
other alternatives this should do what we need.

Thanks.

"Brian Richards" <brichards@gmai l.comwrote in message
news:O%23ffBZ5y GHA.996@TK2MSFT NGP03.phx.gbl.. .

I'm looking for a replacement to NDoc. to generate MSDN style HTML from

xml

documentation. NDoc just doesn't support 2.0 very well and some things
(generics) at all.
>
Thanks
>
Brian
>
>

**Mathieu Cartoixa** · Aug 30 '06, 07:05 AM

Re: NDoc Replacement

Brian Richards a écrit :

I just read about Sandcastle MS's answer to NDoc. Unless anyone knows of any
other alternatives this should do what we need.
>
"Brian Richards" <brichards@gmai l.comwrote in message
news:O%23ffBZ5y GHA.996@TK2MSFT NGP03.phx.gbl.. .

>I'm looking for a replacement to NDoc. to generate MSDN style HTML from

xml

>documentatio n. NDoc just doesn't support 2.0 very well and some things
>(generics) at all.

For the record : http://blogs.msdn.com/sandcastle/default.aspx
NDoc has been abandonned, and Sandcastle, though promising, has yet to
be officially released. I do not know of other aletrnatives.

Mathieu

**William Stacey [MVP]** · Aug 30 '06, 01:25 PM

Re: NDoc Replacement

There is an NDoc build by another guy that does do 2.0 and generics pretty
well. I don't have the url at the moment.

--
William Stacey [MVP]

"Brian Richards" <brichards@gmai l.comwrote in message
news:O%23ffBZ5y GHA.996@TK2MSFT NGP03.phx.gbl.. .
| I'm looking for a replacement to NDoc. to generate MSDN style HTML from
xml
| documentation. NDoc just doesn't support 2.0 very well and some things
| (generics) at all.
|
| Thanks
|
| Brian
|
|

**Brian Gideon** · Aug 30 '06, 02:45 PM

Re: NDoc Replacement

All,

The url is <http://jonas.lagerblad .com/blog/?p=5>. Like you said it
does a pretty good job, but it's far from perfect. I've been using it.

Brian

William Stacey [MVP] wrote:

There is an NDoc build by another guy that does do 2.0 and generics pretty
well. I don't have the url at the moment.
>
--
William Stacey [MVP]
>
"Brian Richards" <brichards@gmai l.comwrote in message
news:O%23ffBZ5y GHA.996@TK2MSFT NGP03.phx.gbl.. .
| I'm looking for a replacement to NDoc. to generate MSDN style HTML from
xml
| documentation. NDoc just doesn't support 2.0 very well and some things
| (generics) at all.
|
| Thanks
|
| Brian
|
|

**Brian Gideon** · Aug 30 '06, 02:45 PM

Re: NDoc Replacement

Mathieu,

The last I heard there is an alpha version of NDoc 2.0, but that's been
awhile. I could be mistaken, but I don't think NDoc is abandoned.

Brian

Mathieu Cartoixa wrote:

For the record : http://blogs.msdn.com/sandcastle/default.aspx
NDoc has been abandonned, and Sandcastle, though promising, has yet to
be officially released. I do not know of other aletrnatives.
>
Mathieu

**Mathieu Cartoixa** · Aug 30 '06, 02:55 PM

Re: NDoc Replacement

Brian Gideon a écrit :

The last I heard there is an alpha version of NDoc 2.0, but that's been
awhile. I could be mistaken, but I don't think NDoc is abandoned.

The only NDoc developer said "I have decided to discontinue work on
NDoc 2.0 and no longer participate in any open-source development work."
(source
http://www.charliedigital.com/PermaL...cde5df9c.aspx).

With Sandcastle on the way, I do not see a very bright future for NDoc.

Mathieu Cartoixa

**Brian Gideon** · Aug 30 '06, 03:55 PM

Re: NDoc Replacement

Mathieu Cartoixa wrote:

The only NDoc developer said "I have decided to discontinue work on
NDoc 2.0 and no longer participate in any open-source development work."
(source
http://www.charliedigital.com/PermaL...cde5df9c.aspx).
>
With Sandcastle on the way, I do not see a very bright future for NDoc.
>
Mathieu Cartoixa

Well, I'm obviously mistaken. That's disappointing, but after reading
that I don't blame the guy at all. I guess I'll move to GhostDoc or
this Sandcastle thing. It looks like the CTP version of Sandcastle was
release a couple of days ago. I hadn't even heard anything about it
until you posted. Thanks for the tip.

**William Stacey [MVP]** · Aug 30 '06, 10:15 PM

Re: NDoc Replacement

That is OS for you. All you get is the requests for new features and nobody
gives you anything. IMO, the guy should have charged $50 awhile back and
got a 2.0 version out a year ago. I would have bought it hands down. As it
stands, someone still needs to put a UI on Sandcastle and integrate it into
VS. That should not be too hard.

--
William Stacey [MVP]

"Brian Gideon" <briangideon@ya hoo.comwrote in message
news:1156953655 .502168.96210@b 28g2000cwb.goog legroups.com...
|
| Mathieu Cartoixa wrote:
| The only NDoc developer said "I have decided to discontinue work on
| NDoc 2.0 and no longer participate in any open-source development work."
| (source
| >
http://www.charliedigital.com/PermaL...cde5df9c.aspx).
| >
| With Sandcastle on the way, I do not see a very bright future for NDoc.
| >
| Mathieu Cartoixa
|
| Well, I'm obviously mistaken. That's disappointing, but after reading
| that I don't blame the guy at all. I guess I'll move to GhostDoc or
| this Sandcastle thing. It looks like the CTP version of Sandcastle was
| release a couple of days ago. I hadn't even heard anything about it
| until you posted. Thanks for the tip.
|

**Steve Barnett** · Aug 31 '06, 07:15 AM

Re: NDoc Replacement

Someone has built a UI. I've been using this one:

http://www.codeproject.com/useritems/SandcastleBuilder.asp

It has a very "Ndoc" feel to it and seems to build very good help files.

Steve

"William Stacey [MVP]" <william.stacey @gmail.comwrote in message
news:OfylbKIzGH A.3704@TK2MSFTN GP02.phx.gbl...

That is OS for you. All you get is the requests for new features and
nobody
gives you anything. IMO, the guy should have charged $50 awhile back and
got a 2.0 version out a year ago. I would have bought it hands down. As
it
stands, someone still needs to put a UI on Sandcastle and integrate it
into
VS. That should not be too hard.
>
--
William Stacey [MVP]
>
"Brian Gideon" <briangideon@ya hoo.comwrote in message
news:1156953655 .502168.96210@b 28g2000cwb.goog legroups.com...
|
| Mathieu Cartoixa wrote:
| The only NDoc developer said "I have decided to discontinue work on
| NDoc 2.0 and no longer participate in any open-source development
work."
| (source
| >
http://www.charliedigital.com/PermaL...cde5df9c.aspx).
| >
| With Sandcastle on the way, I do not see a very bright future for
NDoc.
| >
| Mathieu Cartoixa
|
| Well, I'm obviously mistaken. That's disappointing, but after reading
| that I don't blame the guy at all. I guess I'll move to GhostDoc or
| this Sandcastle thing. It looks like the CTP version of Sandcastle was
| release a couple of days ago. I hadn't even heard anything about it
| until you posted. Thanks for the tip.
|
>
>

**Peter Macej** · Aug 31 '06, 08:15 AM

Re: NDoc Replacement

You can also try our VSdocman, http://www.helixoft.com/blog/archives/25.
It is beta version now but we will release the final version next week.

--
Peter Macej
Helixoft - http://www.helixoft.com
VSdocman - Commenter and generator of class documentation for C#, VB
..NET and ASP .NET code