[TYPO3] documentation in general

[dave ashton]

Well, sorry I posted this to the wrong mailing list. My fault.

>From posting to the wrong mailing list (which I still feel is important to
post to the one I did) you conclude I and others cannot write clear and
concise docs.......

The points I've raised are in previous emails.

How can one update a document with better instructions, if you cannot figure
out the software in the first place!

Full clear, concise with many exampled documentation is what I was bringing
the question up about.

I was previously a teacher and know the importance of clear instructions.
Unless you have learning difficulties, the learning of technical
instructions should be straight forward, although usually slow at the best.

It seems even advanced programmers are finding simple tasks difficult. If
this is not a sign for the future, then I don't know what is.

Dave


-----Original Message-----
From: Matthew Manderson [mailto:matthew at manderson.co.uk] 
Sent: 03 July 2006 12:58
To: typo3-english at lists.netfielders.de
Subject: Re: [TYPO3] documentation in general

Sorry, this entire discussion and the following one should have been in the
documentation mailing list.

If you can't organise a thread how can you organise the documentation?

Documentation is important but keeping it up to date comes at a lot of cost
in terms of time.

Some people say they spent a long time writing new documentation - Where is
it? Post a link and see if the core team will include however TYPO3 remains
one of the most documented systems I have come across. Perhaps you are not
finding the right documents?

If you want to update an extension document, just edit the .sxw in the FREE
to download OpenOffice and email it back to the extension author. Easy job
done.

The new typo3.org remains difficult to use and may be the main reason you
are struggling.

If anything useful comes out of this thread it should be this - If you
really need more documentation write something and contribute it to
wiki.typo3.org yourself instead of expecting others to do it. These pages
are indexed by Google (so you can just ask Google to help find them again)
and the wiki pages do not require you to log in or fill out lots of forms
so it should not affect your busy day too much.

Mantra...contrbute to wiki or update the .sxw yourself. 

Enjoy
Matthew
_______________________________________________
TYPO3-english mailing list
TYPO3-english at lists.netfielders.de
http://lists.netfielders.de/cgi-bin/mailman/listinfo/typo3-english