[Typo3-documentation] Short response... I promise! :-)

[Peter Kindström]

Coby Pachmayr wrote:

>>I don't want to spoil your enhusiasm about your way of working but just
>>realize that, unless you proof it to be easier than the Wiki, I am not
>>going to work on SXW or PDF.
> 
> I agree.  From my "step outline" what I am saying is that everyone
> collaborates in Wiki (not SXW / PDF); a document "manager" is responsible
> for releasing the Wiki version into a printable format.  In fact, I only
> mention those formats because they currently exist;

I like this idea/principle. The only downside is to get enought 
people (or people with enought time) to do it...
Maybe we/you should start only with a few documents? I could 
certainly do it with "my" documents (ie Basic Upgrade).


> I'm sure that many print the documentation so they can easily have it in
> front of them in hard-copy while working on the screen in TYPO3 trying out
> the tutorials etc.  Maybe I'm the only one? :-)

I think we all agree on that! I have printed most of the non 
extension documents by now...


> Hmm.... had another idea (sorry! :-)  ) each document could have a rating
> and comment/review section.  This would allow us (I'm including myself now)
> to quantify how well we are improving the documentation; and allow others to
> point out issues with the document's usability.  I'll have to think on
> whether that could replace the NG idea... or if I'd want to restrict it to
> just rating and comment on usability/mistakes - and keep NG for "help with
> docs".

I think you should consider using the wiki Talk pages for this 
kind of things. It could be prepared with sections like:

  - Rating
  - Comments
  - Suggested improvements
  - Changelog
  etc


-- 

/Peter Kindström, DocTEAM