Comments on: Documenting Castle – The Transformations Begin

By: Symon Rottem

Symon Rottem — Wed, 05 Mar 2008 09:58:35 +0000

@Andy, @deman,
There’s no public repo for the work yet, but once I’ve done the basic restructure I’ll be submitting a patch to the Castle repo. As soon as that’s done I’ll welcome any help I can get on refactoring content, so thanks for your offers.

@Fabrice
Thanks for the link – very useful.

By: deman

deman — Wed, 05 Mar 2008 04:00:10 +0000

yes, i feel the problem. I’m catching up.

Do you put your doc project in any repo? Maybe I can have some look and see how I can contribute.

Thanks.

By: Fabrice Talbot

Fabrice Talbot — Wed, 05 Mar 2008 03:33:15 +0000

I think that this is a good move that will pay off over time.
I did a few migration from unstructured format to Docbook format myself and this
was tedious a time…

My advice would be to spend the time to structure your content well from the
beginning. This is the best way to get maximum benefits from Docbook

Also, you may be interested to visit http://www.livetechdocs.com to review
our online collaboration service for Docbook documentation.

By: Andy

Andy — Tue, 04 Mar 2008 13:31:11 +0000

This is great news! We have a number of projects in production built with Castle and the only criticism I have is the lack of good documentation in one place. You can normally find out how to do things but it takes a lot of searching (current docs/forums/blogs etc) before you find what you need.

If you need some help, I’d be happy to offer my services. Just let me know what you need.

Cheers

Andy

By: Erik Dahlstrand

Erik Dahlstrand — Tue, 04 Mar 2008 09:39:38 +0000

Good luck Symon! I believe good documentation is utmost important to achieve an active and growing community.

By: Symon Rottem

Symon Rottem — Mon, 03 Mar 2008 21:34:12 +0000

Thanks Ken – progress is being made. Stay tuned…

By: Ken Egozi

Ken Egozi — Mon, 03 Mar 2008 07:46:43 +0000

Consider me wishing …