Commenti per Milo Casagrande

Commenti su Of the Importance of Documenting di Weekly links roundup by Communications from DMN

Weekly links roundup by Communications from DMN — Fri, 20 Nov 2009 11:07:41 +0000

[...] The importance of documentation [...]

Commenti su Help the Help di Milo Casagrande: Help the Help | TuxWire : The Linux Blog

Milo Casagrande: Help the Help | TuxWire : The Linux Blog — Mon, 09 Nov 2009 13:04:13 +0000

[...] here to read the rest: Milo Casagrande: Help the Help Share and [...]

Commenti su Of the Importance of Documenting di Twitter Trackbacks for Of the Importance of Documenting « Milo Casagrande [milocasagrande.wordpress.com] on Topsy.com

Mon, 02 Nov 2009 16:36:44 +0000

[...] Of the Importance of Documenting « Milo Casagrande milocasagrande.wordpress.com/2009/11/01/of-the-importance-of-documenting – view page – cached It’s not secret that I started a new job and that I’m now working for a closed-source company (even if sometimes I have to work with my beloved Linux, but unfortunately that’s rare). — From the page [...]

Commenti su Taming the Duck di Milo

Milo — Mon, 02 Nov 2009 13:49:27 +0000

Hadn’t had the time to try Serna out. I heard the news a while back and it looks promising, maybe we can even use it with Mallard, or in the true open-source spirit someone will code a nice application for GNOME.

I agree with you that we don’t hear a lot of noise about DocBook recently, even if s really active. I always felt it as a burden to carry around for writing something that doesn’t need all that vastness. Always felt it as not really agile, even if people are not using all of its potential.

Thanks for the discussion.

Commenti su Of the Importance of Documenting di Milo

Milo — Mon, 02 Nov 2009 12:56:54 +0000

@Jackflap:
Totally agree. But from my POV, the end result of this it’s exactly the opposite (at least for people that have experience in the open-source world): they make you think about looking for another job, ASAP.

Commenti su Of the Importance of Documenting di Jackflap

Jackflap — Mon, 02 Nov 2009 12:12:57 +0000

I was quite surprised with this as well when I first started my current job at a proprietary software company.

Worse of all, it seems to be culturally expected in the badly managed companies not to document, so that employees can ensure they keep their jobs as it makes it more difficult to replace them.

Commenti su Taming the Duck di Tom

Tom — Mon, 02 Nov 2009 12:06:10 +0000

Thanks Milo for your answer.

For the sake of completeness: From my experience with DocBook and talking to others, people have the following difficulties with DocBook:

1. Too many elements
2. Editing/Writing in DocBook is verbose

As I’ve written in my earlier post, (1) is already covered in my last post. One addition: The DocBook Technical Committee chartered a subcommittee about “DocBook for Publishers” which could be interesting for book production (which is probably not what you need.)
My point was: there is a lot of exciting news around DocBook lately, however not all people might know about it.

For (2), this is merely a matter of the right XML editor. Unfortunately, the open source world has not really convincing XML editors in comparison to commercial ones. However, one very promising example is Serna, see http://www.syntext.com/products/serna-free/ They released their editor lately under a free license. It offers a kind of WYSYWYG view, so all the XML elements are completely hidden.

Maybe the second point could be interesting for Mallard as well.

Good luck!

Commenti su Of the Importance of Documenting di Milo Casagrande: Of the Importance of Documenting | TuxWire : The Linux Blog

Sun, 01 Nov 2009 23:36:55 +0000

[...] original here: Milo Casagrande: Of the Importance of Documenting Share and [...]

Commenti su Of the Importance of Documenting di Milo Casagrande: Of the Importance of Documenting | TuxWire : The Linux Blog

Sun, 01 Nov 2009 23:36:26 +0000

[...] the rest here: Milo Casagrande: Of the Importance of Documenting Share and [...]

Commenti su Taming the Duck di Milo

Milo — Sun, 01 Nov 2009 12:12:56 +0000

@Tom
We were using DocBook, but that wasn’t working for us. When Shaun started implementing Mallard, DITA was not around nor DocBook 5 was nearly implemented. What Mallard solve is a GNOME problem, making it easy for people to jump in and start going. DocBook is still to vast and what we need from it is a tiny subset of ell its elements and stuff.
For the stylesheet, GNOME was already using a (almost) custom one with DocBook. The nwalsh one was and still is good, but that wasn’t working for GNOME.

Thanks for the links, really interesting lecture that I didn’t know of.