-
1. Re: Documentation
matkapx Jul 14, 2011 10:55 AM (in response to esteve)Totally agree with you,
I had stated a fresh project with EE 6 and CDI i wanna extend with seam 3. But because of current documentation i was not success to develop with Seam 3 ( and modules)Hope community would work on pretty , effective documentation.
-
2. Re: Documentation
pgmjsd Jul 14, 2011 12:57 PM (in response to esteve)Good comments. Hoping is nice, but contributing documentation is better. :)
-
3. Re: Documentation
lightguard Jul 14, 2011 1:54 PM (in response to esteve)
Joshua Davis wrote on Jul 14, 2011 12:57:
Good comments. Hoping is nice, but contributing documentation is better. :)I couldn't agree with this more
-
4. Re: Documentation
bleathem Jul 14, 2011 4:03 PM (in response to esteve)If we could get some community members contributing documentation, that would free up dev's time to implement new features. There requires a flow of information between the devs and those writing the documentation, but we should be able to work something out there. This direct developer communication would be an advantage for document writers.
Also, we need to make it easier to write documentation. Writing/editing documentation is orders of magnitude easier in a wiki than it is with docbook xml. Let's drop the docbook documentation requirement, and move to something with a lower barrier of entry!
Brian
-
5. Re: Documentation
pgmjsd Jul 14, 2011 4:10 PM (in response to esteve)
Brian Leathem wrote on Jul 14, 2011 16:03:
Also, we need to make it easier to write documentation. Writing/editing documentation is orders of magnitude easier in a wiki than it is with docbook xml. Let's drop the docbook documentation requirement, and move to something with a lower barrier of entry!Agreed. I usually write my notes and documentation on my own wiki for exactly that reason. I'd definitely use a shared wiki if it was available to me.
For example, I have the dubious distinction of having documented 'page.xml'. Search for 'pages.xml', and Google shows my wiki as the first result
-
6. Re: Documentation
andrewwheeler Jul 15, 2011 8:46 PM (in response to esteve)I would like to chip in and give my support for a rethink of the documentation methodology. As has previously been said a change in focus towards the developer with more examples and how-to guides to solve common problems. Secondly, I would also like to see every feature documented. If someone has taken the time to write the code surely it is worth explaining how it works. Java Docs are OK, but sometimes they really don't give you a picture of how it works.
-
7. Re: Documentation
lightguard Jul 16, 2011 3:45 AM (in response to esteve)
Andrew Wheeler wrote on Jul 15, 2011 20:46:
I would like to chip in and give my support for a rethink of the documentation methodology. As has previously been said a change in focus towards the developer with more examples and how-to guides to solve common problems. Secondly, I would also like to see every feature documented. If someone has taken the time to write the code surely it is worth explaining how it works. Java Docs are OK, but sometimes they really don't give you a picture of how it works.Please come to the Seam Community meeting Wednesday 22:00 UTC and we'll discuss documentation and what we can do to make it better.