Antwort: [docbook-apps] General question about creating docbook documents (maybeOT)

[Alexander.Rabenstein@lidl.com]

Hello Frank,

I am looking for a similar solution for our department.
 I am responsible for the software documentation, and the system you are
describing sounds really nice. So is it possible that I can have a look on
it?

Kind Regards





Mit freundlichen Grüßen
i.A. Alexander Rabenstein


Verwaltung International

Telefon: +49 7132 94-296046
Telefax: +49 7132 94-2248

LIDL Stiftung & Co. KG, Stiftsbergstraße 1, 74167 Neckarsulm
Sitz: Neckarsulm, Registergericht Stuttgart HRA 102314, USt.-IdNr.: DE 145
803 808

Komplementäre:
Lidl Stiftung & Co. Beteiligungs-GmbH, Sitz: Neckarsulm, Registergericht
Stuttgart HRB 107937
Geschäftsführer: Marcus Gemmrich, Dr. Martin Golücke, Michael Grandin,
Stefan Herold, Hartmut Kappes, Markus Karcher, Sven Kronenberg, Dirk
Möbius, Eric Riegger, René Sandführ, Jörg Schönenberger, Alexander
Sonnenmoser

LSt Stiftung, rechtsfähige Stiftung privaten Rechts, Sitz: Neckarsulm
Vorstände: Holger Albrecht, Gerd Chrzanowski, Robin Goudsblom, Karl-Heinz
Holland, Patrick Kaudewitz, Hans Christoph Templin



                                                                       
  Von:        Frank Arensmeier <frank@nikemedia.se>                    
                                                                       
  An:         docbook-apps@lists.oasis-open.org                        
                                                                       
  Datum:      14.04.2010 10:02                                         
                                                                       
  Betreff:    [docbook-apps] General question about creating docbook documents (maybe OT)
                                                                       





Hi there.

I would like to ask the list members: how do you create docbook-
compilant XML documents? What does your workflow looks like so to say?
Do you write XML files in a XML editor? A web interface? My apologies
if this is slightly off topic.

I am asking this purely because I am interested (of course...). My
employer is a manufacturer of industrial goods and tools. Until now,
all our technical documentation (mainly operating instructions and
spare parts lists) have been made with Indesign. And over time, we
faced some very big problems:

1) Because technical documentation must be translated into many
different languages, providing translators with documents that they
can edit has been a hassle. In the best case, some translators had
access to Indesign and were able to edit the original document. Re-
using existing translations though wasn't easy / possible with this
approach.

2) Updating existing documentation depends on remembering. E.g if one
needed to change a product name or some technical data, you must know
the documents where that data appears (sometimes, several different
documents are effected by a change and those documents had several
different translations). A simple change could easily take several
hours to do.

3) Keeping track of what was changed, when and by whom had been a real
mystery and still is.

A year ago or so, I was able to convince by employer to utilize a
docbook-based workflow for creating technical documentation. At that
time, I was looking for applications, tools and so on that would make
this workflow feasible. Because some of the guys working with
technical documentation are not very tech savvy, I was looking for a
more or less intuitive, easy-to-use (web-based) solution - without
much success.

However, because I couldn't find anything affordable (some systems
cost about 100.000 EUR), I sat down and developed a system by myself.
The web-based system I came up with makes building a docbook XML file
(and converting to PDF)  a matter of drag-and-drop (with validation of
course), it keeps track of all changes and it is comparably easy to
use for a none-programmer. Besides that, having documentation in many
different languages is now a no-brainer. But every now and then, I was
wondering if there had been a more simple solution.

Regards,
/frank

ps. if someone would like to have a look at the system, you are
welcome to contact me off-list ds.

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org