Dan: Thx for blessing. Catch some sun :) Erlend: It is wonderful idea, to serve "ready to use" system to user, but in this way it opens a big svn control problem (a lot of job to be done), plus, users have to check every page of manual. I would make it simple: when some stable version is out, check plugins, add or change documentation and zip it as 3.52plugins, 3.52documentation. This works nice when you already have structured documentation. Later extending of existing documents with newly described old features is a bit of job (unzip, add pages, add links, zip again, repeat for each documentation set), but you don't have to consider ranges of versions. I know what I'm talking about; we manufacture machines and I write manuals.
Markus: I know, famous German efficiency is talking here :) Completely agree, but it seemed to me that you are more inclined to site.help structured pages than to doc.xxish. I took a look at linked docs and have seen several interesting things: - we are missing some pictures, simple shemes, something to encourage new users - information has to be at hand and quickly readable - but in some chapters. If you take (iPod users guide) Chapter 2 talking about iTunes, it is totaly verbose, just pointing you to iTunes>Help. This tells us that we have two different aproaches to the same person - first, concise information, no sufficient content for guys who already bought the product and second, verbose, for guy who we want to buy our product. Think a bit of this. New users are guys who still did not buy BW (at least for first 50 pages in the wiki) and on the other hand, we, here, need extracted information. - howtos is must-be. Big part of the manual has to be task-oriented. Existing docs is mainly descriptive instead of instructive. Have to run now. Seeya. -- You received this message because you are subscribed to the Google Groups "BoltWire" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/boltwire?hl=en.
