[TYPO3-dev] Ideas backend documentation

[Bernd Wilke]

Christoph Lindenmueller schrieb:
> Hi T3 Dev,
> 
> I wonder what improvements regarding the documentation workflow could be 
> a project for my diploma thesis. I thought about improving the inline 
> help (? symbol) using AJAX and generate OpenOffice "Manuals" for Users.
> 
> What about pulling the help text/images from a wiki in order to make 
> text updates easier?
> 
> What do you think about providing the possility to insert 
> installation-specific help items?
> 
> What are your thoughts how to improve the documentation workflow?

I confess I nearly never used context-help as the information provided 
was of no good to my needs.

This might be because I normaly configure the system (as admin).

For editors this can be a good help to know how they have to fill in 
fields and what they have to watch for. This is information I (=admin) 
can provide.
But this might only belong to this installation. So an exchange to a 
central service might confuse others.

My admin-view: I want a good documentation about features I can 
configure. This mostly means TypoScript. the best documentation yet 
(tsref) lacks imho two things:
1. version information: for every feature/value the version since when 
it was implemented
2. the possibility for everyone to add good examples. espacially for 
beginners the documentation is hard to understand as there are to less 
and to small examples
(maybe something the manuals on php.net)

Bernd

-- 
http://www.pi-phi.de/t3v4/cheatsheet.html