Sandcastle ← Coding Insomnia

Documenting Web Services 6

Mar

2007

I’m now trying to do what really should be very core to any enterprise that is serious about using SOA and web services – making sure that there is an easy way to document your services and to keep that documentation available and updated. Well, it has turned out to be much more painful than ...

MSBuild script for Sandcastle ReadMe

Jan

2007

Installation instructions: If you haven’t already done so, install the Sandcastle December CTP. The scripts rely on a completly unmodified installation, so don’t make any changes to it (especially not the sandcastle.config file). Unzip the contents of Sandcastle.zip to your MSBuild folder (usually c:\Program Files\MSBuild) Unzip the contents of SandcastleTest.zip to wherever you like to ...

MSBuild script December CTP 5

Jan

2007

Time for a new release of the MSBuild script for Sandcastle, this time targeting the Sandcastle December CTP. Download it from the CodePlex site. New in this version: Better support for Sandcastle December CTP A short FAQ Tweet

MSBuild script support for the November CTP 2

Nov

2006

Anand has released yet a new version of the Sandcastle CTP. The November CTP has a couple of fixes and includes support for friendly HTM file names. I've updated the MSBuild script for Sandcastle with this support and I have also moved into my new CodePlex site. So, the download is now found at: http://www.codeplex.com/Release/ProjectReleases.aspx?ProjectName=MSBuildSandcastle&ReleaseId=1029 ...

Finally, support for Sandcastle September CTP 2

Oct

2006

I have updated the MSBuild script for Sandcastle to support the September CTP. You can download the new version in the Downloads section of this site. You'll find the installation instructions there as well. New in this version: Support for Sandcastle September CTP (actually, it is needed) Support for Visual Studio 2005-like help files Support ...

Sandcastle August CTP Released 6

Aug

2006

The team behind Microsoft Sandcastle released a new CTP of Sandcastle yesterday. A couple of changes have been made to the components that will make the previous version of my MSBuild Script for Sandcastle fail. Therefore, you’ll need to download the latest version of the scripts if you want it to work with the August ...

Sandcastle Help Compiler 2 support 3

Aug

2006

Update After installing the August CPT of Sandcastle, you’ll need to update to the latest version of the MSBuild script. I’ve just released a new version of the MSBuild-script for Sandcastle. There are two new features and one new (though optional) requirement. First of all, the new requirement is the Visual Studio .NET Help Integration ...

Sandcastle under the hood, part 3 1

Aug

2006

Welcome to part 3 of my Sandcastle under the hood-series. In part 2, which focused on all the different components available to use in the BuildAssembler, I promised you a walkthrough of the sandcastle.config that was delivered in the July CTP of Sandcastle. So here we go! Input to BuildAssembler First of all a reminder ...

Sandcastle under the hood, part 2

Aug

2006

In my previous post, I talked you through the first steps of the Sandcastle build process. So far it’s been more or less simple xsl transforms, but now we’re getting to the fun part – the BuildAssembler. The BuildAssembler is actually just a small console application that runs an XML document through a configurable pipeline ...

Sandcastle under the hood, part 1

Aug

2006

Well, today I’ve been diving into the innards of Sandcastle. In lack of proper documentation I’ve relied on ildasm, some trace output and some common sense. Now, I don’t know how much of this that is actually correct, but I suspect that at least most of it is rather close to the truth. Assuming you ...