Apr 08

MonoRail ‘Getting Started’ Docs Refactored

Tag: CastleSymon Rottem @ 10:22 pm

Well, that’s that done for now. *dusting hands*

I’ve been working my way through the Getting started chapter of the MonoRail documentation and have refactored a lot of the content, fixed the links so they land where they’re supposed to and added a few extra explanations. The current version can be viewed online here:

http://www.symbiotic-development.com/monorail/html

Thanks to a patch from Louis DeJardin (who provided the Windows Workflow Foundation facility in Castle) there are now navigation links at the top of the page to allow you to choose chunked, single or CHM versions of the content.

There appear to be a lot of problems with the DocBook syntax highlighter – it’s very fragile and not nearly as flexible as I’d like. I think I’m going to have to take a hack at the xslthl package and see if I can figure it out. Or if anyone else out there feels like it… :)

I’d love comments, suggestions or patches for anything that’s not clear or incorrect so feel free to dive on in.

Related Posts
DocBook MonoRail Docs in Contrib
Documenting Castle – Phase One Complete
Where does all the time go?
Open Source Documentation
NServiceBus is Growing Up!

4 Responses to “MonoRail ‘Getting Started’ Docs Refactored”

  1. Louis says:

    Thanks again for putting this together. It’s been very helpful.

  2. Roelof Blom says:

    Looks good Symon, I like it! I am wondering if you are still working on it?

    – Roelof.

  3. Symon Rottem says:

    I am still working on it, but I’ve been distracted by the death of a server, building a new one and getting some automated remote backups running in an environment I’m new to. Contributions are still welcome, of course… :)

  4. Eric Hauser says:

    Symon,

    Your docs rock. Not sure if you are still updating them, but in your localization example you should change the default key from “text” to something else. Apparently, Monorail has a text helper which it defines using the text key. Took me awhile to figure that one out =)

Leave a Reply

Subscribe without commenting