InfoQ

InfoQ

News

My Bookmarks

Login or Register to enable bookmarks for unlimited time.

The content has been bookmarked!

There was an error bookmarking this content! Please retry.

Sandcastle’s Team Manager Dismisses Rumors About Project Termination

Posted by Abel Avram on Jan 20, 2009

Sections
Enterprise Architecture,
Operations & Infrastructure,
Process & Practices,
Architecture & Design,
Development
Topics
Open Source ,
Announcements ,
.NET ,
Artifacts & Tools
Tags
Sandcastle

To dismiss any rumors about the termination of the Sandcastle project, Anand Raman, Group Manager within the Microsoft Developer Division, has posted an update on the current status of the project. Sandcastle is a tool used for generating MSDN-like documentation by reflecting over the source code of a .NET project.

Sandcastle’s source code was released on CodePlex about 6 months ago following protests after the project was posted there without the source code. After that, Anand said that his team worked on including the MSDN Library with VS 2008 SP1. Currently, their plan is to release a series of fixes by the end of January:

  • I did not provide a SLN file for the projects.  You could create your own, but it would be more convenient to provide one in the source distribution.
  • In the SLN file created from the previous source distribution, users encountered the following when trying to build this way:
    • Each project has TFS source control information which is not valid for people outside my team.  This will be stripped for the source distribution.
    • Most projects specify a strong name key file which doesn't exist in the package.  The project files should disable signing, or a dummy key.snk should be provided.
    • The MoreComponents project doesn't build; has errors such as "'Microsoft.Ddue.Tools.BuildComponent' does not contain a constructor that takes '1' arguments".  It seems that this is a non-essential project and maybe should not be included at all.
    • The MrefBuilderStatic project doesn't build; has errors such as "The type or namespace name 'RootFilter' could not be found (are you missing a using directive or an assembly reference?)".  I will remove this project.
    • BuildAssemblerConsole references the CommandLine project at an incorrect path.
    • The BuildAssembler and BuildAssemblerConsole projects appear to be duplicates and BuildAssemblerConsole doesn't build.
  • After unloading the problematic projects, users able to get everything built.  Unfortunately, there are 115 warnings in the build.  These should really be fixed as a best practice.

  • There are lots of Code Analysis (FxCop) warnings.  We should set a good example by eliminating such warnings from the code we ship.

  • There are many files that pertain to the NT build system and should be excluded from the source distribution (makefile, makefile.inc, placefile, etc.).

Anand said the team will focus on a new set of features and fixes after VS 2010 Beta 1 is released:

1. Version we will be using to ship .NET Framework 4.0

2. Support for F# syntax

3. XSD documenter

4. Attributes supporting Microsoft Help 3 viewer.

Sandcastle is released under the Microsoft Public License (Ms-PL).

No comments

Watch Thread Reply

Educational Content

Jesper Boeg on Priming Kanban

In this interview, Jesper Boeg, author of the new InfoQ book – Priming Kanban, discusses the keys to using Kanban effectively, and how to get started if you are currently using other approaches.

New-age Transactional Systems - Not Your Grandpa's OLTP

John Hugg discusses high volume transaction processing applications with high and low frequency profiles, and how VoltDB can be used for that purpose.

Cool Code

Kevlin Henney examines code samples to see what can be learned from them starting from the premise that one won’t write great code unless he knows how to read it.

Collaboration: At the Extremities of Extreme

Jason Ayers share the observations he made watching a team of developers collaborating in real time on the same code base, pushing XP, pair programming and continuous integration to their extremes.

Yesod Web Framework

Michael Snoyman presents Yesod, a web framework written in Haskell and containing a web server, templating, ORM, libraries (templating, gravatar, etc.).

Transactions without Transactions

Richard Kreuter and Kyle Banker on how to avoid classical RDBMS transactional systems by using compensation mechanisms, transactional messaging or transactional procedures.

Attila Szegedi on JVM and GC Performance Tuning at Twitter

Attila Szegedi talks about performance tuning Java and Scala programs at Twitter: how to approach GC problems, the importance of asynchronous I/O, when to use MySQL/Cassandra/Redis, and much more.

10 tips on how to prevent business value risk

One category of risk that project teams need to ensure they address is business value failure – delivering a product that fails to provide value for the business investor.