473,770 Members | 4,029 Online
Bytes | Software Development & Data Engineering Community
+ Post

Home Posts Topics Members FAQ

SandCastle x NDoc 2.0

Folks,
Is anyone stuck like me, in choosing between SandCastle (the new MS doc
support) and NDoc 2.0 framework?
Ive downloaded NDoc 2.0 but it does not compile quite well. On the other
hand, SandCastle seems to be too childish to use it for real in professional
app...

Any opinions?
Aug 10 '06 #1
2 2177
"Bruce One" <ra**@virtualso ftware.com.brwr ote in message
news:E5******** *************** ***********@mic rosoft.com...
Is anyone stuck like me, in choosing between SandCastle (the new MS doc
support) and NDoc 2.0 framework?
Ive downloaded NDoc 2.0 but it does not compile quite well. On the other
hand, SandCastle seems to be too childish to use it for real in
professional
app...
I would say wait a little longer for SandCastle. They claim that it is the
tool MS used to generate all of the FCL documentation, so I think it is not
so childish...

<QUOTE>
During VS 2005 ship cycle we wrote Sandcastle to ship .NET Framework
documentation for MSDN online and offline libraries.
</QUOTE>

Here is their blog.

http://blogs.msdn.com/sandcastle/

NDoc is dead.

-- Alan
Aug 10 '06 #2
Bruce One wrote:
Folks,
Is anyone stuck like me, in choosing between SandCastle (the new MS
doc support) and NDoc 2.0 framework?
Ive downloaded NDoc 2.0 but it does not compile quite well. On the
other hand, SandCastle seems to be too childish to use it for real in
professional app...

Any opinions?
If you have to deliver NOW, and sandcastle doesn't cut it, go for a
commercial offering. The least saddest solution I could find (which
also has some weird bugs, but at least it seems to produce a document
in most cases) is documentx 5.

If you can wait a little longer, wait for sandcastle and a gui
frontend.

FB

--
------------------------------------------------------------------------
Lead developer of LLBLGen Pro, the productive O/R mapper for .NET
LLBLGen Pro website: http://www.llblgen.com
My .NET blog: http://weblogs.asp.net/fbouma
Microsoft MVP (C#)
------------------------------------------------------------------------
Aug 11 '06 #3

This thread has been closed and replies have been disabled. Please start a new discussion.

Similar topics

7
2602
by: Ash Moollan [InfoMaster] | last post by:
Hi there, I am using NDOC to generate docs for one C# project which I wrote. My assembly has some public classes that are not meant to be used by others and I have not documented them. I would like NDOC not to generate documentation for those public classes that do not have an XML documentation. Can anyone suggest how I do that? All help much appreciated
11
1426
by: julien | last post by:
Hello, I posted this question on the NDoc-user mailing list, but it looks like a dead list (no messages for 10 days!). I'd like to use NDoc tags or custom tags inside methods like: void Mymethod() { ..... <mytag>...</mytag> .... }
0
1573
by: Pakmanoncrack | last post by:
The software company I work for creates 4 chm files from c# code with ndoc and then combines them into a fifth chm file by merging through html help. This is all done through a dos build and there are no manual steps between each process. We need it to stay that way. Here is the problem: a few classes found in one of the chm files (we will call it a.chm) use an object that is found in another chm file(b.chm). Since ndoc created the chm...
7
3031
by: Lonifasiko | last post by:
I need something like NDoc that supports .NET Framework 2.0? I've downloaded last NDoc but did not work with 2.0 assemblies. Also googled deep enough to find this URL that seems to be down: http://ndoc.sourceforge.net/wiki/dotNet_2.0_Support Any other ideas?
9
1988
by: =?Utf-8?B?TWFyY0c=?= | last post by:
Is there a relatively straightforward way to get Sandcastle hooked into the asp.net 2.0 development process? I have a C# app I'm developing that has code in both the root and App_Code directories. Sorry for the post here - only confilicting info in the various blogs. Thanks, Marc
8
1859
by: Kuldeep | last post by:
Framework: Visual Studio 2005 Technology: ASP.NET 2.0 Language: C#.NET 2.0 Hi All, Could any one of you please let me know how to use NDoc in Visual Studio 2005. If there is a source where I can find step by step information, I would be greatly obliged.
4
4563
by: Peter Lykkegaard | last post by:
Hi gotdotnet is being phased out Anyone knows where I get a copy of the NDOC add-on for VB.NET? Yeah I know about time to move on and start using VS 2005 :) tia/Peter (repost from m.p.d.framework)
0
1607
by: dami.gupta | last post by:
I am building a chm file using sandcastle and am following instructions on https://blogs.msdn.com/sandcastle/archive/2006/07/29/682398.aspx I am following all the commands which are proceeding kind of ok, until I get to hhc output\test.hhp
0
1113
by: silpa | last post by:
Hi, For Generating Website for API documentation using Sandcastle I opened Powershell window and gave the command scbuild –framework 2.0 –sources Class1.dll,comments.xml –BuildWebsite An error is thrown which is as follows:
0
9602
marktang
by: marktang | last post by:
ONU (Optical Network Unit) is one of the key components for providing high-speed Internet services. Its primary function is to act as an endpoint device located at the user's premises. However, people are often confused as to whether an ONU can Work As a Router. In this blog post, we’ll explore What is ONU, What Is Router, ONU & Router’s main usage, and What is the difference between ONU and Router. Let’s take a closer look ! Part I. Meaning of...
0
9439
by: Hystou | last post by:
Most computers default to English, but sometimes we require a different language, especially when relocating. Forgot to request a specific language before your computer shipped? No problem! You can effortlessly switch the default language on Windows 10 without reinstalling. I'll walk you through it. First, let's disable language synchronization. With a Microsoft account, language settings sync across devices. To prevent any complications,...
0
10237
Oralloy
by: Oralloy | last post by:
Hello folks, I am unable to find appropriate documentation on the type promotion of bit-fields when using the generalised comparison operator "<=>". The problem is that using the GNU compilers, it seems that the internal comparison operator "<=>" tries to promote arguments from unsigned to signed. This is as boiled down as I can make it. Here is my compilation command: g++-12 -std=c++20 -Wnarrowing bit_field.cpp Here is the code in...
1
10017
by: Hystou | last post by:
Overview: Windows 11 and 10 have less user interface control over operating system update behaviour than previous versions of Windows. In Windows 11 and 10, there is no way to turn off the Windows Update option using the Control Panel or Settings app; it automatically checks for updates and installs any it finds, whether you like it or not. For most users, this new feature is actually very convenient. If you want to control the update process,...
0
9882
tracyyun
by: tracyyun | last post by:
Dear forum friends, With the development of smart home technology, a variety of wireless communication protocols have appeared on the market, such as Zigbee, Z-Wave, Wi-Fi, Bluetooth, etc. Each protocol has its own unique characteristics and advantages, but as a user who is planning to build a smart home system, I am a bit confused by the choice of these technologies. I'm particularly interested in Zigbee because I've heard it does some...
1
7431
isladogs
by: isladogs | last post by:
The next Access Europe User Group meeting will be on Wednesday 1 May 2024 starting at 18:00 UK time (6PM UTC+1) and finishing by 19:30 (7.30PM). In this session, we are pleased to welcome a new presenter, Adolph Dupré who will be discussing some powerful techniques for using class modules. He will explain when you may want to use classes instead of User Defined Types (UDT). For example, to manage the data in unbound forms. Adolph will...
0
6690
by: conductexam | last post by:
I have .net C# application in which I am extracting data from word file and save it in database particularly. To store word all data as it is I am converting the whole word file firstly in HTML and then checking html paragraph one by one. At the time of converting from word file to html my equations which are in the word document file was convert into image. Globals.ThisAddIn.Application.ActiveDocument.Select();...
0
5326
by: TSSRALBI | last post by:
Hello I'm a network technician in training and I need your help. I am currently learning how to create and manage the different types of VPNs and I have a question about LAN-to-LAN VPNs. The last exercise I practiced was to create a LAN-to-LAN VPN between two Pfsense firewalls, by using IPSEC protocols. I succeeded, with both firewalls in the same network. But I'm wondering if it's possible to do the same thing, with 2 Pfsense firewalls...
3
2832
bsmnconsultancy
by: bsmnconsultancy | last post by:
In today's digital era, a well-designed website is crucial for businesses looking to succeed. Whether you're a small business owner or a large corporation in Toronto, having a strong online presence can significantly impact your brand's success. BSMN Consultancy, a leader in Website Development in Toronto offers valuable insights into creating effective websites that not only look great but also perform exceptionally well. In this comprehensive...

By using Bytes.com and it's services, you agree to our Privacy Policy and Terms of Use.

To disable or enable advertisements and analytics tracking please visit the manage ads & tracking page.