Hi Sharan, all, I most likely cannot attend the Skype call so I will add some thoughts here.
I think we should set up a small documentation quality team which is responsible that the documentation send in by contributors is of good quality, consistent and (mostly) error free. This team should also propose the structure of the documentation and maybe add the empty .adoc files and includes to lead the way for contributors.
I'd volunteer to be part of this team.It could also be a good idea to track who is working on a piece of documentation to avoid double work and encourage collaboration between contributors interested in the same topic(s). I think this might be Jira with a main task containing the main "rules" of documentation and several subtasks for each topic.
I suggest to have also a process to move documentation from the Wiki to the documentation in the repository. We should make sure that we do not have different documentation in both places. If someone is working on a topic he also could search the Wiki for it and try to merge/move it where applicable.
Moved/merged documentation from the Wiki should then be moved to an adoc Attic until everthing is cleared and the community agrees to remove it from the Wiki.
We should also define which contents should be in the repository and what the Wiki should contain or be linked to.
These are my first thoughts, happy to get some feedback and news from the Skype call.
Thanks, Michael Brohl ecomify GmbH www.ecomify.de Am 21.02.18 um 09:21 schrieb Sharan Foga:
Hi All
Thanks for all the feedback received about the documentation effort. It is
great to see so many people wanting to be involved as part of the team. Based
on the feedback I've seen so far I would like to confirm the date and time of
the Skype call next week to kick start the documentation effort.
The call will be on Tuesday 27th February at 14.00 (UTC+1)
See below for what this time is for other UTC times
UTC-5 (New York, Boston): 08.00
UTC+1 (Czech Republic, Germany, France, Italy) : 14.00
UTC+2 (South Africa): 15.00
UTC+3 (Kuwait) : 16.00
UTC+5 (Pakistan) : 18.00
UTC+5.5 (India) : 18.30
Please remember that anyone and everyone can join the team at any time and you
don't need to be an expert in OFBiz to contribute to it. In fact I think that
people new to OFBiz have a unique perspective and can let us know if what has
been written is easy to understand!
If you can't make the call, then don't worry as we will be writing up the notes
about what was discussed and post the details to the mailing list.
Thanks
Sharan
smime.p7s
Description: S/MIME Cryptographic Signature
