[Typo3-doc] Invitation to join the main T3 Doc mailing list

[Alex Heizer]

Hi everyone,

There has been some great activity surrounding the T3 documentation! We 
have a bunch of manuals reviewed (which has been updated today on 
http://test.typo3.us -- please check it and make sure I didn't forget 
anyone! :) ), and discussion about the wiki, and document formats in 
general. Most of the discussion lately has occurred on the main TYPO3 
doc mailing list, and I was reminded that it's probable that not all of 
us are signed up there. Please take the opportunity to sign up and join 
in with any thoughts, suggestions, questions or concerns!

http://lists.netfielders.de/cgi-bin/mailman/listinfo/typo3-project-documentation

To sum up as best I can, the discussions have mostly been about 
streamlining the existing information, and determining the needs for a 
document workflow system. In other words, if we were to build a 
documentation extension, and assign users and groups, what features 
would the extension have for editors and end-users, and what groups 
would have access to which parts of the extension? This is, of course, 
an incredibly basic oversimplification of the discussion, but that's 
where we are at these days.

We have generally agreed that we want wiki-like functionality for the 
editors, multiple output formats for end-users, and an easy-to-use 
system or information organization (think: current Documentation Matrix 
revisited). We also discussed possible roles for writers, reviewers and 
maintainers of all of the information, including "ownership" of 
documents by DocTeam members, "ownership" of categories of documents by 
DocTeam groups, DocTeam members who oversee the documentation structure 
and/or the system, and so on.

Also, since we need to end up with a single system of documentation, it 
may be best to just have all of the documentation discussions on the 
main Doc list instead of the T3 US list. This is mostly my fault since I 
began the US-English documentation discussions on the T3US list, but I 
guess it was a good thing in order for the US team to get it together 
before going back to the main group with suggestions and questions about 
our place in the greater scheme of things.

So feel free to join in and contribute what you can!

Cheers!
Alex