Great initiative! How does is this going to fit into our new website initiative?
Best regards, Pierre Smits ORRTIZ.COM <http://www.orrtiz.com> OFBiz based solutions & services OFBiz Extensions Marketplace http://oem.ofbizci.net/oci-2/ On Tue, May 30, 2017 at 11:12 AM, Taher Alkhateeb < [email protected]> wrote: > +1 > > Fantastic initiative. > > On Tue, May 30, 2017 at 12:10 PM, Sharan Foga <[email protected]> > wrote: > > > Excellent and thanks for the link Michael! > > > > Thanks > > Sharan > > > > > > On 30/05/17 11:07, Michael Brohl wrote: > > > >> Hi Sharan, Craig, > >> > >> this is great and will fit well into the Wiki restructure efforts. > >> > >> For the FAQ or how-tos, we can check the user questions and start with > >> the most frequently asked questions/answers found on the mailing lists > and > >> stack overflow [1]. > >> > >> Looking forward to your documentation results, > >> > >> best regards, > >> > >> Michael Brohl > >> ecomify GmbH > >> www.ecomify.de > >> > >> [1] https://stackoverflow.com/questions/tagged/ofbiz > >> > >> > >> Am 30.05.17 um 10:12 schrieb Sharan Foga: > >> > >>> Hi All > >>> > >>> Craig Parker and I are planning to take on our End User Documentation > >>> problem. Our goal is to improve the OFBiz documentation and provide > some > >>> useful information for users and non-technical people. We plan to work > on > >>> the following: > >>> > >>> *_OFBiz Glossary_* > >>> > >>> * Put together a full glossary of OFBiz terms so that the concepts are > >>> clear (things like catalogs, parties, even products can be confusing > >>> when trying to explain what they are) > >>> > >>> *_Menu Structured Documentation _* > >>> > >>> * This will follow the existing menu structure and will eventually > >>> replace / update the current in application screen help that is > >>> already in OFBiz. > >>> * The focus of this effort will be to standardise the information and > >>> complete missing information initially for core modules and official > >>> plugins > >>> > >>> *_End User Guide_* > >>> > >>> * This will give users an overview of the applications and processes > >>> * It will include a list of basic tasks for each process > >>> * It will also include links to examples > >>> > >>> *_How Tos_* > >>> > >>> * This will be a quick reference How-To by area (for example the first > >>> set of these will focus on downloading and installing OFBiz) > >>> > >>> *_Examples and Tutorials_* > >>> > >>> * This will provide practical examples of using the applications in a > >>> real life scenario > >>> * It will build understanding (and familiarity) by having a common > >>> theme or story > >>> > >>> *_Training Matrix_* > >>> > >>> * We also talked about putting together some form of Training Matrix > >>> but I think that could be done after the other content has been > >>> developed. > >>> > >>> *_Implementation Strategy and Next Steps_* > >>> I'd like to temporarily recover and use the End User Docs workspace to > >>> prepare all of these. I prefer using a separate space where we won't > need > >>> to be concerned about the wiki re-organisation. Also at the moment > there is > >>> already some user documentation in the End User Docs workspace so we > can > >>> review that as part of the documentation effort and incorporate it or > >>> re-write it where it necessary. > >>> > >>> Another idea is that the End User Docs workspace could be a good place > >>> to store what will become the replacement for our in application screen > >>> sensitive help. The main thing we are missing is content - once we > have the > >>> content we look at extracting it into whatever format we need. > >>> > >>> As the documentation sections are completed we will move them over to > >>> the re-organised documentation space in the wiki. > >>> > >>> At this stage we are going to be having any documentation discussions > >>> etc on this list but the aim is that this effort will eventually also > >>> encourage contributions and feedback from our user community. > >>> > >>> Also if anyone else is interested in helping contribute to this effort > >>> then please let me know. > >>> > >>> Thanks > >>> Sharan > >>> > >>> > >>> > >> > >> > > >
