I can understand that people will go to the forum more often than to look for changes in the docs. Afaik, there is some view in the works that displays the changes to the docs in a more detailed and longer history so you would just check that every so often.
The documentation is meant to be Wiki style, so actually, if you discover something or you get an answer in the forum, it would be really cool if you could take a minute and add it to the appropriate place in the docs (or maybe just edit one of the pages already there).
One of the nice features of the new documentation area is the commenting that is now allowed. Im a fan of the www.php.net style of comments on manual pages that allow people to enter their ideas, problems, examples of the relevant section. I hope that will be repeated here and tips and tricks slowly appear with the appropriate documentation.
It has good to see that those posters who have been using the forum for a while now tend to link to a good post or good piece of documentation explaining something a person is looking for. In time this will likely expand to linking to the tips and tricks in the documentation. Consquently there will be good search results for a problem someone is having.
Good points in both replies. As I mentioned, I am concerned that the documentation is not left behind. For that matter, I am excited about the ability to add comments to the documentation as I have found it quite a useful feature for the PHP docs myself.
So, modifying my initial ideas a bit... I would love to see an improved method of displaying new comments/additions to the documentation, which as Karsten mentioned is in the works. Woohoo! :)
Well, as I was writing an extended paragraph discussing why I still want a Tip & Tricks area I realized that the Contributions section matches what I am looking for, I just hadn't connected the two. It has been a looooong week.
Alex
Alex
[ bald_technologist on the IRC channel (irc.freenode.net): #eZpublish ]
Mabye a tips and tricks forum could be the incoming are for the docs. We could then make a documentation page and organize tips after they're discussed.
