Difference between revisions of "Talk:Collaborative Documentation Solutions"
Colin-adams (Talk | contribs) |
|||
| Line 1: | Line 1: | ||
Using a wiki (or anything that requires to use a web-browser) is a real pain for writing documentation. The web browser is an extremely hostile environment for text editing, and I for one would never attempt to write an substantial text using it. | Using a wiki (or anything that requires to use a web-browser) is a real pain for writing documentation. The web browser is an extremely hostile environment for text editing, and I for one would never attempt to write an substantial text using it. | ||
--[[User:Colin-adams|Colin-adams]] 06:53, 11 June 2008 (PDT) | --[[User:Colin-adams|Colin-adams]] 06:53, 11 June 2008 (PDT) | ||
| + | |||
| + | --[[User:Jfiat|Jocelyn]] 08:34, 11 June 2008 (PDT): I agree online editing is not always that nice, but we can hope - that in the future - there are offline (or remote desktop) editor which help. Or any better online editor using rich interface technologies. Anyway editing wiki online, is much easier than editing XML (docbook, DITA,...) online. I know doc-wiki provides such online editor, or even STORM editor for DITA, but for now, they are just heavy and not that convenient. | ||
| + | Currently we have doc_builder (internal tool) to edit our xmldoc (internal format) to maintain our doc and generate either HTML or .CHM, and to centralize the content, we use subversion. This works ok, but using the doc_builder tool is not nice, and when someone wants to contribute, this is not easy. So online content system seems a good alternative. | ||
Revision as of 07:34, 11 June 2008
Using a wiki (or anything that requires to use a web-browser) is a real pain for writing documentation. The web browser is an extremely hostile environment for text editing, and I for one would never attempt to write an substantial text using it. --Colin-adams 06:53, 11 June 2008 (PDT)
--Jocelyn 08:34, 11 June 2008 (PDT): I agree online editing is not always that nice, but we can hope - that in the future - there are offline (or remote desktop) editor which help. Or any better online editor using rich interface technologies. Anyway editing wiki online, is much easier than editing XML (docbook, DITA,...) online. I know doc-wiki provides such online editor, or even STORM editor for DITA, but for now, they are just heavy and not that convenient. Currently we have doc_builder (internal tool) to edit our xmldoc (internal format) to maintain our doc and generate either HTML or .CHM, and to centralize the content, we use subversion. This works ok, but using the doc_builder tool is not nice, and when someone wants to contribute, this is not easy. So online content system seems a good alternative.
