You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@ofbiz.apache.org by Sharan Foga <sh...@apache.org> on 2018/02/07 13:32:56 UTC
OFBiz Documentation Team Volunteers Needed
Hi Everyone
(Trying again as my first post didn't reach this list)
If you have read the latest project blog post then you will have seen a section about the discussions that have been happening on our development list about the new proposed OFBiz documentation framework.
https://s.apache.org/VfxE
It is based on asciidoc and will be able to generate documentation in various formats. This means that we can start to consolidate our OFBiz documentation within OFBiz itself and adapt it to any new releases.
Feedback to the proposal have been very positive and once the code is moved into our current trunk we will need to start some documentation work. We will be looking for volunteers to become part of a documentation team that will work on reviewing the documents we already have in the wiki and other sources, then help to re-structure them to fit into the new documentation framework model.
Being involved with documentation is a good way to learn OFBiz :-)
So if you are interested in being part of the OFBiz documentation team then please respond to this message and I will add you to the list.
Thanks
Sharan
Re: OFBiz Documentation Team Volunteers Needed
Posted by Swapnil Mane <sw...@hotwaxsystems.com>.
Thanks for the updates Sharan, please count me in.
- Best Regards,
Swapnil M Mane,
www.hotwaxsystems.com
On Wed, Feb 7, 2018 at 7:02 PM, Sharan Foga <sh...@apache.org> wrote:
> Hi Everyone
>
> (Trying again as my first post didn't reach this list)
>
> If you have read the latest project blog post then you will have seen a
> section about the discussions that have been happening on our development
> list about the new proposed OFBiz documentation framework.
>
> https://s.apache.org/VfxE
>
> It is based on asciidoc and will be able to generate documentation in
> various formats. This means that we can start to consolidate our OFBiz
> documentation within OFBiz itself and adapt it to any new releases.
>
> Feedback to the proposal have been very positive and once the code is
> moved into our current trunk we will need to start some documentation work.
> We will be looking for volunteers to become part of a documentation team
> that will work on reviewing the documents we already have in the wiki and
> other sources, then help to re-structure them to fit into the new
> documentation framework model.
>
> Being involved with documentation is a good way to learn OFBiz :-)
>
> So if you are interested in being part of the OFBiz documentation team
> then please respond to this message and I will add you to the list.
>
> Thanks
> Sharan
>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Arthur Marquez <ar...@gmail.com>.
Sharan,
I'm uncertain how I wold be able to contribute. However, I'm deeply
curious, so place me in the queue!
Arthur
*Arthur Marquez*
*1-701-872-4471 : Office*
*1-818-919-5452 : Mobile*
*Farmers Union Oil Company of Beach ND*
*Farmers Union Propane, C3H8*
*90 NE 1st St.*
*Beach ND 58621*
*http://www.cenexofbeach.com/ <http://www.cenexofbeach.com/>*
On Wed, Feb 7, 2018 at 6:32 AM, Sharan Foga <sh...@apache.org> wrote:
> Hi Everyone
>
> (Trying again as my first post didn't reach this list)
>
> If you have read the latest project blog post then you will have seen a
> section about the discussions that have been happening on our development
> list about the new proposed OFBiz documentation framework.
>
> https://s.apache.org/VfxE
>
> It is based on asciidoc and will be able to generate documentation in
> various formats. This means that we can start to consolidate our OFBiz
> documentation within OFBiz itself and adapt it to any new releases.
>
> Feedback to the proposal have been very positive and once the code is
> moved into our current trunk we will need to start some documentation work.
> We will be looking for volunteers to become part of a documentation team
> that will work on reviewing the documents we already have in the wiki and
> other sources, then help to re-structure them to fit into the new
> documentation framework model.
>
> Being involved with documentation is a good way to learn OFBiz :-)
>
> So if you are interested in being part of the OFBiz documentation team
> then please respond to this message and I will add you to the list.
>
> Thanks
> Sharan
>
Re: OFBiz Documentation Team Volunteers Needed
Posted by deepak nigam <de...@gmail.com>.
Hi Sharan,
Please consider me in.
Thanks & Regard
--
Deepak Nigam
On Feb 7, 2018 7:02 PM, "Sharan Foga" <sh...@apache.org> wrote:
> Hi Everyone
>
> (Trying again as my first post didn't reach this list)
>
> If you have read the latest project blog post then you will have seen a
> section about the discussions that have been happening on our development
> list about the new proposed OFBiz documentation framework.
>
> https://s.apache.org/VfxE
>
> It is based on asciidoc and will be able to generate documentation in
> various formats. This means that we can start to consolidate our OFBiz
> documentation within OFBiz itself and adapt it to any new releases.
>
> Feedback to the proposal have been very positive and once the code is
> moved into our current trunk we will need to start some documentation work.
> We will be looking for volunteers to become part of a documentation team
> that will work on reviewing the documents we already have in the wiki and
> other sources, then help to re-structure them to fit into the new
> documentation framework model.
>
> Being involved with documentation is a good way to learn OFBiz :-)
>
> So if you are interested in being part of the OFBiz documentation team
> then please respond to this message and I will add you to the list.
>
> Thanks
> Sharan
>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Jacques Le Roux <ja...@les7arts.com>.
I agree, actually as experience learned us, to create a good documentation is more a question of structuring the documentation to avoid what we have
now in Confluence: a mess with a lot of obsolete (or hard to tell) pages :D
By using asciidoc, a version control tools to have the documentation as OFBiz code it should be easier to avoid that.
I note though that it's all about reviewing, it was already possible in Confluence but it did not work because it was harder to follow, organise and
structure.
I think we already agreed about using Confluence as less as possible. Mostly for important generic points like Guides, FAQ, Tutos, etc.
In Confluence we can also import data from svn, it's already used for some specific stuff like Gradle.
I use https://svn.apache.org/repos/asf/ofbiz/tools/updateWiki.bat for that, not sure it's the best way, but for now it helps. The basic idea is to
have a SPOF (ie only one place for the source).
So we could for instance migrate, after cleaning and deleting a lot, the important Confluence content to keep in a main documentation sub-dir (under
OFBiz root) under a format or another and render it automatically in HTML format to import into Confluence
I read that some projects use o want to use BuibBot/Jenkins and https://jekyllrb.com/ for doing somehow that
Just an idea...
Jacques
Le 08/02/2018 à 14:25, Michael Brohl a écrit :
> +++1 for manually reviewing, updating, restructuring and enhancing the documentation instead of copy & paste!
>
> We know that the documentation has very different quality, is sometimes outdated or too brief etc.
>
> I think it is of more value to take the chance to make the documentation itself better in the course of the migration instead of simply having the
> old state in a new format.
>
> We should maybe also agree on writing new documentation (or anhancing a good amount of documentation) directly in the new format instead of putting
> it in confluence 8if applicable)?
>
> Thanks,
>
> Michael
>
>
> Am 08.02.18 um 11:33 schrieb Taher Alkhateeb:
>> It is heartwarming to see you fine people signing up. I am thrilled
>> and looking forward to working with you. And I have to say Sharan
>> knows how to bring us together, so thank you!
>>
>> In reference to Olivier's comment regarding using conversion tools, I
>> would advise to perhaps try to be careful. Our objective is not
>> necessarily to copy-paste existing documentation, but rather to write
>> clean, relevant and well thought out documentation. If an old piece of
>> documentation is good and relevant, we use it, if not, we update it
>> and clean it, or of it is not useful then we just drop it.
>>
>> I hope more people feel the urge to sign up. What you folks are going
>> to achieve is to make OFBiz much more competitive by giving
>> accessibility to new comers through comprehensive documentation.
>>
>> On Thu, Feb 8, 2018 at 1:04 PM, Aditya Sharma
>> <ad...@hotwaxsystems.com> wrote:
>>> Hi Sharan,
>>>
>>> Please count me in.
>>>
>>> Thanks and Regards,
>>>
>>> *Aditya Sharma* | Enterprise Software Engineer
>>> HotWax Commerce <http://www.hotwax.co/> by HotWax Systems
>>> <http://www.hotwaxsystems.com/>
>>>
>>> <https://www.linkedin.com/in/aditya-sharma-78291810a/>
>>>
>>> On Thu, Feb 8, 2018 at 2:25 PM, Olivier Heintz <
>>> holivier.lists@ofbizextra.org> wrote:
>>>
>>>> Hi Sharan,
>>>>
>>>> please add me to the list,
>>>>
>>>> I have start to play with the new tools
>>>> I have convert some docbook file to asciidoc with docbookrx tools and make
>>>> modification on help data to use the html generated files in the ofbiz
>>>> help, it's work's ;-)
>>>> If needed, I can convert all docbook files to asccidoc
>>>>
>>>>
>>>> Regards,
>>>>
>>>>
>>>>
>>>> Le 07/02/2018 à 14:32, Sharan Foga a écrit :
>>>>> Hi Everyone
>>>>>
>>>>> (Trying again as my first post didn't reach this list)
>>>>>
>>>>> If you have read the latest project blog post then you will have seen a
>>>> section about the discussions that have been happening on our development
>>>> list about the new proposed OFBiz documentation framework.
>>>>> https://s.apache.org/VfxE
>>>>>
>>>>> It is based on asciidoc and will be able to generate documentation in
>>>> various formats. This means that we can start to consolidate our OFBiz
>>>> documentation within OFBiz itself and adapt it to any new releases.
>>>>> Feedback to the proposal have been very positive and once the code is
>>>> moved into our current trunk we will need to start some documentation work.
>>>> We will be looking for volunteers to become part of a documentation team
>>>> that will work on reviewing the documents we already have in the wiki and
>>>> other sources, then help to re-structure them to fit into the new
>>>> documentation framework model.
>>>>> Being involved with documentation is a good way to learn OFBiz :-)
>>>>>
>>>>> So if you are interested in being part of the OFBiz documentation team
>>>> then please respond to this message and I will add you to the list.
>>>>> Thanks
>>>>> Sharan
>>>>>
>>>>
>
>
--
Jacques Le Roux
400E Chemin de la Mouline
34560 Poussan
04 67 51 19 38
06 11 79 50 28
Re: OFBiz Documentation Team Volunteers Needed
Posted by Jacques Le Roux <ja...@les7arts.com>.
I just stumbled upon https://blogs.gnome.org/pmkovar/2015/10/27/converting-docbook-into-asciidoc/ which is a bit old but seems to say that docbookrx
is more powerful
Le 10/02/2018 à 11:21, Jacques Le Roux a écrit :
> Hi Olivier,
>
> I read at https://github.com/asciidoctor/docbookrx that
> "This converter is far from perfect at the moment and some of the conversion is done hastily. The plan is to evolve it into a robust library for
> performing this conversion in a reliable way."
>
> The last version of Pandoc (2.1.1) supports conversion from docbook to asciido. I have tried it but it seems not all is supported for instance using
> HELP_ACCOUNTING_agreements.xml (picked by chance)
> pandoc -f docbook -t asciidoc HELP_ACCOUNTING_agreements.xml -o test.txt
> in
> applications\accounting\data\helpdata
>
> I get this:
> <<
> Agreements.
> -----------
>
> An agreement is a way of recording a business arrangements or contract
> that your business makes with other companies or individuals. Common
> examples include Payment Terms (where you allow a customer up to 30 days
> to pay you) or Prompt Payment Discounts (where you offer a reduction on
> the amount owing if your customer pays you before a certain date)
>
> It can be used for the following:
>
> * Defining Payment Terms for Customers or Suppliers
> * Defining Sales Commissions
> * Setting up Prompt Payment Discounts
> * Setting up Price Lists (NOTE TO DO: Need to investigate how this logic
> overlaps with PRICE RULES in Catalog Manager)
> * Defining Late Fee Penalties
> * Defining preferred freight carriers or specific codes to be used
> >>
>
> At 1st glance the text is limited in width to something like 72 chars I guess/hope this can be changed.
> And the included/linked documents are not present.
> And yes, asciidoc can link
> http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#links
> https://github.com/asciidoctor/asciidoctor/wiki/How-to-link-to-a-relative-AsciiDoc-document
>
> Could you please try the same with docbookrx to see if we get something better?
>
> I agree about the importance of the contextual help in its 2 aspects
>
> 1. From the "?" or "Help" button in UI
> 2. as an URL like https://demo-trunk.ofbiz.apache.org/cmssite/cms/APACHE_OFBIZ_HTML
>
> We could create a branch to convert all as you suggest and see what is exploitable.
>
> Thanks
>
> Jacques
>
> Le 09/02/2018 à 10:48, Olivier Heintz a écrit :
>> good tools are tools which help to work not to (try to) replace human works. :-)
>>
>> 1) Conversion from docbook to asciidoc will just help us to work on content and not on technical syntax.
>>
>> 2) Current ofbiz help system has some weakness but it works and, as it's easy, to update data to use it with html file generate from ascii it's a good
>> tools to test if some content is usable (or not) in a contextual help.
>> But I agree, I don't know when contextual help will be in the task list of the Documentation team ;-)
>>
>> Olivier
>>
>> Le 08/02/2018 à 14:25, Michael Brohl a écrit :
>>> +++1 for manually reviewing, updating, restructuring and enhancing the
>>> documentation instead of copy & paste!
>>>
>>> We know that the documentation has very different quality, is sometimes
>>> outdated or too brief etc.
>>>
>>> I think it is of more value to take the chance to make the documentation
>>> itself better in the course of the migration instead of simply having
>>> the old state in a new format.
>>>
>>> We should maybe also agree on writing new documentation (or anhancing a
>>> good amount of documentation) directly in the new format instead of
>>> putting it in confluence 8if applicable)?
>>>
>>> Thanks,
>>>
>>> Michael
>>>
>>>
>>> Am 08.02.18 um 11:33 schrieb Taher Alkhateeb:
>>>> It is heartwarming to see you fine people signing up. I am thrilled
>>>> and looking forward to working with you. And I have to say Sharan
>>>> knows how to bring us together, so thank you!
>>>>
>>>> In reference to Olivier's comment regarding using conversion tools, I
>>>> would advise to perhaps try to be careful. Our objective is not
>>>> necessarily to copy-paste existing documentation, but rather to write
>>>> clean, relevant and well thought out documentation. If an old piece of
>>>> documentation is good and relevant, we use it, if not, we update it
>>>> and clean it, or of it is not useful then we just drop it.
>>>>
>>>> I hope more people feel the urge to sign up. What you folks are going
>>>> to achieve is to make OFBiz much more competitive by giving
>>>> accessibility to new comers through comprehensive documentation.
>>>>
>>>> On Thu, Feb 8, 2018 at 1:04 PM, Aditya Sharma
>>>> <ad...@hotwaxsystems.com> wrote:
>>>>> Hi Sharan,
>>>>>
>>>>> Please count me in.
>>>>>
>>>>> Thanks and Regards,
>>>>>
>>>>> *Aditya Sharma* | Enterprise Software Engineer
>>>>> HotWax Commerce<http://www.hotwax.co/> by HotWax Systems
>>>>> <http://www.hotwaxsystems.com/>
>>>>>
>>>>> <https://www.linkedin.com/in/aditya-sharma-78291810a/>
>>>>>
>>>>> On Thu, Feb 8, 2018 at 2:25 PM, Olivier Heintz <
>>>>> holivier.lists@ofbizextra.org> wrote:
>>>>>
>>>>>> Hi Sharan,
>>>>>>
>>>>>> please add me to the list,
>>>>>>
>>>>>> I have start to play with the new tools
>>>>>> I have convert some docbook file to asciidoc with docbookrx tools and make
>>>>>> modification on help data to use the html generated files in the ofbiz
>>>>>> help, it's work's ;-)
>>>>>> If needed, I can convert all docbook files to asccidoc
>>>>>>
>>>>>>
>>>>>> Regards,
>>>>>>
>>>>>>
>>>>>>
>>>>>> Le 07/02/2018 à 14:32, Sharan Foga a écrit :
>>>>>>> Hi Everyone
>>>>>>>
>>>>>>> (Trying again as my first post didn't reach this list)
>>>>>>>
>>>>>>> If you have read the latest project blog post then you will have seen a
>>>>>> section about the discussions that have been happening on our development
>>>>>> list about the new proposed OFBiz documentation framework.
>>>>>>> https://s.apache.org/VfxE
>>>>>>>
>>>>>>> It is based on asciidoc and will be able to generate documentation in
>>>>>> various formats. This means that we can start to consolidate our OFBiz
>>>>>> documentation within OFBiz itself and adapt it to any new releases.
>>>>>>> Feedback to the proposal have been very positive and once the code is
>>>>>> moved into our current trunk we will need to start some documentation work.
>>>>>> We will be looking for volunteers to become part of a documentation team
>>>>>> that will work on reviewing the documents we already have in the wiki and
>>>>>> other sources, then help to re-structure them to fit into the new
>>>>>> documentation framework model.
>>>>>>> Being involved with documentation is a good way to learn OFBiz :-)
>>>>>>>
>>>>>>> So if you are interested in being part of the OFBiz documentation team
>>>>>> then please respond to this message and I will add you to the list.
>>>>>>> Thanks
>>>>>>> Sharan
>>>>>>>
>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Jacques Le Roux <ja...@les7arts.com>.
Hi Olivier,
I read at https://github.com/asciidoctor/docbookrx that
"This converter is far from perfect at the moment and some of the conversion is done hastily. The plan is to evolve it into a robust library for
performing this conversion in a reliable way."
The last version of Pandoc (2.1.1) supports conversion from docbook to asciido. I have tried it but it seems not all is supported for instance using
HELP_ACCOUNTING_agreements.xml (picked by chance)
pandoc -f docbook -t asciidoc HELP_ACCOUNTING_agreements.xml -o test.txt
in
applications\accounting\data\helpdata
I get this:
<<
Agreements.
-----------
An agreement is a way of recording a business arrangements or contract
that your business makes with other companies or individuals. Common
examples include Payment Terms (where you allow a customer up to 30 days
to pay you) or Prompt Payment Discounts (where you offer a reduction on
the amount owing if your customer pays you before a certain date)
It can be used for the following:
* Defining Payment Terms for Customers or Suppliers
* Defining Sales Commissions
* Setting up Prompt Payment Discounts
* Setting up Price Lists (NOTE TO DO: Need to investigate how this logic
overlaps with PRICE RULES in Catalog Manager)
* Defining Late Fee Penalties
* Defining preferred freight carriers or specific codes to be used
>>
At 1st glance the text is limited in width to something like 72 chars I guess/hope this can be changed.
And the included/linked documents are not present.
And yes, asciidoc can link
http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#links
https://github.com/asciidoctor/asciidoctor/wiki/How-to-link-to-a-relative-AsciiDoc-document
Could you please try the same with docbookrx to see if we get something better?
I agree about the importance of the contextual help in its 2 aspects
1. From the "?" or "Help" button in UI
2. as an URL like https://demo-trunk.ofbiz.apache.org/cmssite/cms/APACHE_OFBIZ_HTML
We could create a branch to convert all as you suggest and see what is exploitable.
Thanks
Jacques
Le 09/02/2018 à 10:48, Olivier Heintz a écrit :
> good tools are tools which help to work not to (try to) replace human works. :-)
>
> 1) Conversion from docbook to asciidoc will just help us to work on content and not on technical syntax.
>
> 2) Current ofbiz help system has some weakness but it works and, as it's easy, to update data to use it with html file generate from ascii it's a good
> tools to test if some content is usable (or not) in a contextual help.
> But I agree, I don't know when contextual help will be in the task list of the Documentation team ;-)
>
> Olivier
>
> Le 08/02/2018 à 14:25, Michael Brohl a écrit :
>> +++1 for manually reviewing, updating, restructuring and enhancing the
>> documentation instead of copy & paste!
>>
>> We know that the documentation has very different quality, is sometimes
>> outdated or too brief etc.
>>
>> I think it is of more value to take the chance to make the documentation
>> itself better in the course of the migration instead of simply having
>> the old state in a new format.
>>
>> We should maybe also agree on writing new documentation (or anhancing a
>> good amount of documentation) directly in the new format instead of
>> putting it in confluence 8if applicable)?
>>
>> Thanks,
>>
>> Michael
>>
>>
>> Am 08.02.18 um 11:33 schrieb Taher Alkhateeb:
>>> It is heartwarming to see you fine people signing up. I am thrilled
>>> and looking forward to working with you. And I have to say Sharan
>>> knows how to bring us together, so thank you!
>>>
>>> In reference to Olivier's comment regarding using conversion tools, I
>>> would advise to perhaps try to be careful. Our objective is not
>>> necessarily to copy-paste existing documentation, but rather to write
>>> clean, relevant and well thought out documentation. If an old piece of
>>> documentation is good and relevant, we use it, if not, we update it
>>> and clean it, or of it is not useful then we just drop it.
>>>
>>> I hope more people feel the urge to sign up. What you folks are going
>>> to achieve is to make OFBiz much more competitive by giving
>>> accessibility to new comers through comprehensive documentation.
>>>
>>> On Thu, Feb 8, 2018 at 1:04 PM, Aditya Sharma
>>> <ad...@hotwaxsystems.com> wrote:
>>>> Hi Sharan,
>>>>
>>>> Please count me in.
>>>>
>>>> Thanks and Regards,
>>>>
>>>> *Aditya Sharma* | Enterprise Software Engineer
>>>> HotWax Commerce <http://www.hotwax.co/> by HotWax Systems
>>>> <http://www.hotwaxsystems.com/>
>>>>
>>>> <https://www.linkedin.com/in/aditya-sharma-78291810a/>
>>>>
>>>> On Thu, Feb 8, 2018 at 2:25 PM, Olivier Heintz <
>>>> holivier.lists@ofbizextra.org> wrote:
>>>>
>>>>> Hi Sharan,
>>>>>
>>>>> please add me to the list,
>>>>>
>>>>> I have start to play with the new tools
>>>>> I have convert some docbook file to asciidoc with docbookrx tools and make
>>>>> modification on help data to use the html generated files in the ofbiz
>>>>> help, it's work's ;-)
>>>>> If needed, I can convert all docbook files to asccidoc
>>>>>
>>>>>
>>>>> Regards,
>>>>>
>>>>>
>>>>>
>>>>> Le 07/02/2018 à 14:32, Sharan Foga a écrit :
>>>>>> Hi Everyone
>>>>>>
>>>>>> (Trying again as my first post didn't reach this list)
>>>>>>
>>>>>> If you have read the latest project blog post then you will have seen a
>>>>> section about the discussions that have been happening on our development
>>>>> list about the new proposed OFBiz documentation framework.
>>>>>> https://s.apache.org/VfxE
>>>>>>
>>>>>> It is based on asciidoc and will be able to generate documentation in
>>>>> various formats. This means that we can start to consolidate our OFBiz
>>>>> documentation within OFBiz itself and adapt it to any new releases.
>>>>>> Feedback to the proposal have been very positive and once the code is
>>>>> moved into our current trunk we will need to start some documentation work.
>>>>> We will be looking for volunteers to become part of a documentation team
>>>>> that will work on reviewing the documents we already have in the wiki and
>>>>> other sources, then help to re-structure them to fit into the new
>>>>> documentation framework model.
>>>>>> Being involved with documentation is a good way to learn OFBiz :-)
>>>>>>
>>>>>> So if you are interested in being part of the OFBiz documentation team
>>>>> then please respond to this message and I will add you to the list.
>>>>>> Thanks
>>>>>> Sharan
>>>>>>
>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Olivier Heintz <ho...@ofbizextra.org>.
good tools are tools which help to work not to (try to) replace human works. :-)
1) Conversion from docbook to asciidoc will just help us to work on content and not on technical syntax.
2) Current ofbiz help system has some weakness but it works and, as it's easy, to update data to use it with html file generate from ascii it's a good
tools to test if some content is usable (or not) in a contextual help.
But I agree, I don't know when contextual help will be in the task list of the Documentation team ;-)
Olivier
Le 08/02/2018 à 14:25, Michael Brohl a écrit :
> +++1 for manually reviewing, updating, restructuring and enhancing the
> documentation instead of copy & paste!
>
> We know that the documentation has very different quality, is sometimes
> outdated or too brief etc.
>
> I think it is of more value to take the chance to make the documentation
> itself better in the course of the migration instead of simply having
> the old state in a new format.
>
> We should maybe also agree on writing new documentation (or anhancing a
> good amount of documentation) directly in the new format instead of
> putting it in confluence 8if applicable)?
>
> Thanks,
>
> Michael
>
>
> Am 08.02.18 um 11:33 schrieb Taher Alkhateeb:
>> It is heartwarming to see you fine people signing up. I am thrilled
>> and looking forward to working with you. And I have to say Sharan
>> knows how to bring us together, so thank you!
>>
>> In reference to Olivier's comment regarding using conversion tools, I
>> would advise to perhaps try to be careful. Our objective is not
>> necessarily to copy-paste existing documentation, but rather to write
>> clean, relevant and well thought out documentation. If an old piece of
>> documentation is good and relevant, we use it, if not, we update it
>> and clean it, or of it is not useful then we just drop it.
>>
>> I hope more people feel the urge to sign up. What you folks are going
>> to achieve is to make OFBiz much more competitive by giving
>> accessibility to new comers through comprehensive documentation.
>>
>> On Thu, Feb 8, 2018 at 1:04 PM, Aditya Sharma
>> <ad...@hotwaxsystems.com> wrote:
>>> Hi Sharan,
>>>
>>> Please count me in.
>>>
>>> Thanks and Regards,
>>>
>>> *Aditya Sharma* | Enterprise Software Engineer
>>> HotWax Commerce <http://www.hotwax.co/> by HotWax Systems
>>> <http://www.hotwaxsystems.com/>
>>>
>>> <https://www.linkedin.com/in/aditya-sharma-78291810a/>
>>>
>>> On Thu, Feb 8, 2018 at 2:25 PM, Olivier Heintz <
>>> holivier.lists@ofbizextra.org> wrote:
>>>
>>>> Hi Sharan,
>>>>
>>>> please add me to the list,
>>>>
>>>> I have start to play with the new tools
>>>> I have convert some docbook file to asciidoc with docbookrx tools and make
>>>> modification on help data to use the html generated files in the ofbiz
>>>> help, it's work's ;-)
>>>> If needed, I can convert all docbook files to asccidoc
>>>>
>>>>
>>>> Regards,
>>>>
>>>>
>>>>
>>>> Le 07/02/2018 à 14:32, Sharan Foga a écrit :
>>>>> Hi Everyone
>>>>>
>>>>> (Trying again as my first post didn't reach this list)
>>>>>
>>>>> If you have read the latest project blog post then you will have seen a
>>>> section about the discussions that have been happening on our development
>>>> list about the new proposed OFBiz documentation framework.
>>>>> https://s.apache.org/VfxE
>>>>>
>>>>> It is based on asciidoc and will be able to generate documentation in
>>>> various formats. This means that we can start to consolidate our OFBiz
>>>> documentation within OFBiz itself and adapt it to any new releases.
>>>>> Feedback to the proposal have been very positive and once the code is
>>>> moved into our current trunk we will need to start some documentation work.
>>>> We will be looking for volunteers to become part of a documentation team
>>>> that will work on reviewing the documents we already have in the wiki and
>>>> other sources, then help to re-structure them to fit into the new
>>>> documentation framework model.
>>>>> Being involved with documentation is a good way to learn OFBiz :-)
>>>>>
>>>>> So if you are interested in being part of the OFBiz documentation team
>>>> then please respond to this message and I will add you to the list.
>>>>> Thanks
>>>>> Sharan
>>>>>
>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Michael Brohl <mi...@ecomify.de>.
+++1 for manually reviewing, updating, restructuring and enhancing the
documentation instead of copy & paste!
We know that the documentation has very different quality, is sometimes
outdated or too brief etc.
I think it is of more value to take the chance to make the documentation
itself better in the course of the migration instead of simply having
the old state in a new format.
We should maybe also agree on writing new documentation (or anhancing a
good amount of documentation) directly in the new format instead of
putting it in confluence 8if applicable)?
Thanks,
Michael
Am 08.02.18 um 11:33 schrieb Taher Alkhateeb:
> It is heartwarming to see you fine people signing up. I am thrilled
> and looking forward to working with you. And I have to say Sharan
> knows how to bring us together, so thank you!
>
> In reference to Olivier's comment regarding using conversion tools, I
> would advise to perhaps try to be careful. Our objective is not
> necessarily to copy-paste existing documentation, but rather to write
> clean, relevant and well thought out documentation. If an old piece of
> documentation is good and relevant, we use it, if not, we update it
> and clean it, or of it is not useful then we just drop it.
>
> I hope more people feel the urge to sign up. What you folks are going
> to achieve is to make OFBiz much more competitive by giving
> accessibility to new comers through comprehensive documentation.
>
> On Thu, Feb 8, 2018 at 1:04 PM, Aditya Sharma
> <ad...@hotwaxsystems.com> wrote:
>> Hi Sharan,
>>
>> Please count me in.
>>
>> Thanks and Regards,
>>
>> *Aditya Sharma* | Enterprise Software Engineer
>> HotWax Commerce <http://www.hotwax.co/> by HotWax Systems
>> <http://www.hotwaxsystems.com/>
>>
>> <https://www.linkedin.com/in/aditya-sharma-78291810a/>
>>
>> On Thu, Feb 8, 2018 at 2:25 PM, Olivier Heintz <
>> holivier.lists@ofbizextra.org> wrote:
>>
>>> Hi Sharan,
>>>
>>> please add me to the list,
>>>
>>> I have start to play with the new tools
>>> I have convert some docbook file to asciidoc with docbookrx tools and make
>>> modification on help data to use the html generated files in the ofbiz
>>> help, it's work's ;-)
>>> If needed, I can convert all docbook files to asccidoc
>>>
>>>
>>> Regards,
>>>
>>>
>>>
>>> Le 07/02/2018 à 14:32, Sharan Foga a écrit :
>>>> Hi Everyone
>>>>
>>>> (Trying again as my first post didn't reach this list)
>>>>
>>>> If you have read the latest project blog post then you will have seen a
>>> section about the discussions that have been happening on our development
>>> list about the new proposed OFBiz documentation framework.
>>>> https://s.apache.org/VfxE
>>>>
>>>> It is based on asciidoc and will be able to generate documentation in
>>> various formats. This means that we can start to consolidate our OFBiz
>>> documentation within OFBiz itself and adapt it to any new releases.
>>>> Feedback to the proposal have been very positive and once the code is
>>> moved into our current trunk we will need to start some documentation work.
>>> We will be looking for volunteers to become part of a documentation team
>>> that will work on reviewing the documents we already have in the wiki and
>>> other sources, then help to re-structure them to fit into the new
>>> documentation framework model.
>>>> Being involved with documentation is a good way to learn OFBiz :-)
>>>>
>>>> So if you are interested in being part of the OFBiz documentation team
>>> then please respond to this message and I will add you to the list.
>>>> Thanks
>>>> Sharan
>>>>
>>>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Taher Alkhateeb <sl...@gmail.com>.
It is heartwarming to see you fine people signing up. I am thrilled
and looking forward to working with you. And I have to say Sharan
knows how to bring us together, so thank you!
In reference to Olivier's comment regarding using conversion tools, I
would advise to perhaps try to be careful. Our objective is not
necessarily to copy-paste existing documentation, but rather to write
clean, relevant and well thought out documentation. If an old piece of
documentation is good and relevant, we use it, if not, we update it
and clean it, or of it is not useful then we just drop it.
I hope more people feel the urge to sign up. What you folks are going
to achieve is to make OFBiz much more competitive by giving
accessibility to new comers through comprehensive documentation.
On Thu, Feb 8, 2018 at 1:04 PM, Aditya Sharma
<ad...@hotwaxsystems.com> wrote:
> Hi Sharan,
>
> Please count me in.
>
> Thanks and Regards,
>
> *Aditya Sharma* | Enterprise Software Engineer
> HotWax Commerce <http://www.hotwax.co/> by HotWax Systems
> <http://www.hotwaxsystems.com/>
>
> <https://www.linkedin.com/in/aditya-sharma-78291810a/>
>
> On Thu, Feb 8, 2018 at 2:25 PM, Olivier Heintz <
> holivier.lists@ofbizextra.org> wrote:
>
>> Hi Sharan,
>>
>> please add me to the list,
>>
>> I have start to play with the new tools
>> I have convert some docbook file to asciidoc with docbookrx tools and make
>> modification on help data to use the html generated files in the ofbiz
>> help, it's work's ;-)
>> If needed, I can convert all docbook files to asccidoc
>>
>>
>> Regards,
>>
>>
>>
>> Le 07/02/2018 à 14:32, Sharan Foga a écrit :
>> > Hi Everyone
>> >
>> > (Trying again as my first post didn't reach this list)
>> >
>> > If you have read the latest project blog post then you will have seen a
>> section about the discussions that have been happening on our development
>> list about the new proposed OFBiz documentation framework.
>> >
>> > https://s.apache.org/VfxE
>> >
>> > It is based on asciidoc and will be able to generate documentation in
>> various formats. This means that we can start to consolidate our OFBiz
>> documentation within OFBiz itself and adapt it to any new releases.
>> >
>> > Feedback to the proposal have been very positive and once the code is
>> moved into our current trunk we will need to start some documentation work.
>> We will be looking for volunteers to become part of a documentation team
>> that will work on reviewing the documents we already have in the wiki and
>> other sources, then help to re-structure them to fit into the new
>> documentation framework model.
>> >
>> > Being involved with documentation is a good way to learn OFBiz :-)
>> >
>> > So if you are interested in being part of the OFBiz documentation team
>> then please respond to this message and I will add you to the list.
>> >
>> > Thanks
>> > Sharan
>> >
>>
>>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Aditya Sharma <ad...@hotwaxsystems.com>.
Hi Sharan,
Please count me in.
Thanks and Regards,
*Aditya Sharma* | Enterprise Software Engineer
HotWax Commerce <http://www.hotwax.co/> by HotWax Systems
<http://www.hotwaxsystems.com/>
<https://www.linkedin.com/in/aditya-sharma-78291810a/>
On Thu, Feb 8, 2018 at 2:25 PM, Olivier Heintz <
holivier.lists@ofbizextra.org> wrote:
> Hi Sharan,
>
> please add me to the list,
>
> I have start to play with the new tools
> I have convert some docbook file to asciidoc with docbookrx tools and make
> modification on help data to use the html generated files in the ofbiz
> help, it's work's ;-)
> If needed, I can convert all docbook files to asccidoc
>
>
> Regards,
>
>
>
> Le 07/02/2018 à 14:32, Sharan Foga a écrit :
> > Hi Everyone
> >
> > (Trying again as my first post didn't reach this list)
> >
> > If you have read the latest project blog post then you will have seen a
> section about the discussions that have been happening on our development
> list about the new proposed OFBiz documentation framework.
> >
> > https://s.apache.org/VfxE
> >
> > It is based on asciidoc and will be able to generate documentation in
> various formats. This means that we can start to consolidate our OFBiz
> documentation within OFBiz itself and adapt it to any new releases.
> >
> > Feedback to the proposal have been very positive and once the code is
> moved into our current trunk we will need to start some documentation work.
> We will be looking for volunteers to become part of a documentation team
> that will work on reviewing the documents we already have in the wiki and
> other sources, then help to re-structure them to fit into the new
> documentation framework model.
> >
> > Being involved with documentation is a good way to learn OFBiz :-)
> >
> > So if you are interested in being part of the OFBiz documentation team
> then please respond to this message and I will add you to the list.
> >
> > Thanks
> > Sharan
> >
>
>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Olivier Heintz <ho...@ofbizextra.org>.
Hi Sharan,
please add me to the list,
I have start to play with the new tools
I have convert some docbook file to asciidoc with docbookrx tools and make modification on help data to use the html generated files in the ofbiz help, it's work's ;-)
If needed, I can convert all docbook files to asccidoc
Regards,
Le 07/02/2018 à 14:32, Sharan Foga a écrit :
> Hi Everyone
>
> (Trying again as my first post didn't reach this list)
>
> If you have read the latest project blog post then you will have seen a section about the discussions that have been happening on our development list about the new proposed OFBiz documentation framework.
>
> https://s.apache.org/VfxE
>
> It is based on asciidoc and will be able to generate documentation in various formats. This means that we can start to consolidate our OFBiz documentation within OFBiz itself and adapt it to any new releases.
>
> Feedback to the proposal have been very positive and once the code is moved into our current trunk we will need to start some documentation work. We will be looking for volunteers to become part of a documentation team that will work on reviewing the documents we already have in the wiki and other sources, then help to re-structure them to fit into the new documentation framework model.
>
> Being involved with documentation is a good way to learn OFBiz :-)
>
> So if you are interested in being part of the OFBiz documentation team then please respond to this message and I will add you to the list.
>
> Thanks
> Sharan
>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Jacques Le Roux <ja...@les7arts.com>.
Hi Sharan, All,
Some time ago I created https://issues.apache.org/jira/browse/OFBIZ-9423
Not sure if we want use it in this context or if we have another new Jira more appropriate and then I close OFBIZ-9423 which is maybe too much and
confusing. I was more advocating update wiki documentation from source then.
Jacques
Le 07/02/2018 à 14:32, Sharan Foga a écrit :
> Hi Everyone
>
> (Trying again as my first post didn't reach this list)
>
> If you have read the latest project blog post then you will have seen a section about the discussions that have been happening on our development list about the new proposed OFBiz documentation framework.
>
> https://s.apache.org/VfxE
>
> It is based on asciidoc and will be able to generate documentation in various formats. This means that we can start to consolidate our OFBiz documentation within OFBiz itself and adapt it to any new releases.
>
> Feedback to the proposal have been very positive and once the code is moved into our current trunk we will need to start some documentation work. We will be looking for volunteers to become part of a documentation team that will work on reviewing the documents we already have in the wiki and other sources, then help to re-structure them to fit into the new documentation framework model.
>
> Being involved with documentation is a good way to learn OFBiz :-)
>
> So if you are interested in being part of the OFBiz documentation team then please respond to this message and I will add you to the list.
>
> Thanks
> Sharan
>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Piotr Walesiak <pw...@gmail.com>.
Hello,
Not sure whether i can help much since i'm quite new to OFBiz. However
count me in, pls.
P.
08.02.2018 9:29 AM "Michael Brohl" <mi...@ecomify.de> napisał(a):
> Hi Sharan,
>
> please add me to the list :-)
>
> Regards,
>
> Michael
>
> Am 07.02.18 um 14:32 schrieb Sharan Foga:
>
>> Hi Everyone
>>
>> (Trying again as my first post didn't reach this list)
>>
>> If you have read the latest project blog post then you will have seen a
>> section about the discussions that have been happening on our development
>> list about the new proposed OFBiz documentation framework.
>>
>> https://s.apache.org/VfxE
>>
>> It is based on asciidoc and will be able to generate documentation in
>> various formats. This means that we can start to consolidate our OFBiz
>> documentation within OFBiz itself and adapt it to any new releases.
>>
>> Feedback to the proposal have been very positive and once the code is
>> moved into our current trunk we will need to start some documentation work.
>> We will be looking for volunteers to become part of a documentation team
>> that will work on reviewing the documents we already have in the wiki and
>> other sources, then help to re-structure them to fit into the new
>> documentation framework model.
>>
>> Being involved with documentation is a good way to learn OFBiz :-)
>>
>> So if you are interested in being part of the OFBiz documentation team
>> then please respond to this message and I will add you to the list.
>>
>> Thanks
>> Sharan
>>
>
>
>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Pranay Pandey <pr...@hotwax.co>.
Hi Sharan,
Please count me in.
Best regards,
Pranay Pandey
www.hotwax.co
On Thu, Feb 8, 2018 at 1:59 PM, Michael Brohl <mi...@ecomify.de>
wrote:
> Hi Sharan,
>
> please add me to the list :-)
>
> Regards,
>
> Michael
>
> Am 07.02.18 um 14:32 schrieb Sharan Foga:
>
> Hi Everyone
>>
>> (Trying again as my first post didn't reach this list)
>>
>> If you have read the latest project blog post then you will have seen a
>> section about the discussions that have been happening on our development
>> list about the new proposed OFBiz documentation framework.
>>
>> https://s.apache.org/VfxE
>>
>> It is based on asciidoc and will be able to generate documentation in
>> various formats. This means that we can start to consolidate our OFBiz
>> documentation within OFBiz itself and adapt it to any new releases.
>>
>> Feedback to the proposal have been very positive and once the code is
>> moved into our current trunk we will need to start some documentation work.
>> We will be looking for volunteers to become part of a documentation team
>> that will work on reviewing the documents we already have in the wiki and
>> other sources, then help to re-structure them to fit into the new
>> documentation framework model.
>>
>> Being involved with documentation is a good way to learn OFBiz :-)
>>
>> So if you are interested in being part of the OFBiz documentation team
>> then please respond to this message and I will add you to the list.
>>
>> Thanks
>> Sharan
>>
>
>
>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Pranay Pandey <pr...@hotwaxsystems.com>.
Hi Sharan,
Please count me in.
Best regards,
Pranay Pandey
www.hotwaxsystems.com
www.hotwax.co
On Thu, Feb 8, 2018 at 1:59 PM, Michael Brohl <mi...@ecomify.de>
wrote:
> Hi Sharan,
>
> please add me to the list :-)
>
> Regards,
>
> Michael
>
> Am 07.02.18 um 14:32 schrieb Sharan Foga:
>
> Hi Everyone
>>
>> (Trying again as my first post didn't reach this list)
>>
>> If you have read the latest project blog post then you will have seen a
>> section about the discussions that have been happening on our development
>> list about the new proposed OFBiz documentation framework.
>>
>> https://s.apache.org/VfxE
>>
>> It is based on asciidoc and will be able to generate documentation in
>> various formats. This means that we can start to consolidate our OFBiz
>> documentation within OFBiz itself and adapt it to any new releases.
>>
>> Feedback to the proposal have been very positive and once the code is
>> moved into our current trunk we will need to start some documentation work.
>> We will be looking for volunteers to become part of a documentation team
>> that will work on reviewing the documents we already have in the wiki and
>> other sources, then help to re-structure them to fit into the new
>> documentation framework model.
>>
>> Being involved with documentation is a good way to learn OFBiz :-)
>>
>> So if you are interested in being part of the OFBiz documentation team
>> then please respond to this message and I will add you to the list.
>>
>> Thanks
>> Sharan
>>
>
>
>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Michael Brohl <mi...@ecomify.de>.
Hi Sharan,
please add me to the list :-)
Regards,
Michael
Am 07.02.18 um 14:32 schrieb Sharan Foga:
> Hi Everyone
>
> (Trying again as my first post didn't reach this list)
>
> If you have read the latest project blog post then you will have seen a section about the discussions that have been happening on our development list about the new proposed OFBiz documentation framework.
>
> https://s.apache.org/VfxE
>
> It is based on asciidoc and will be able to generate documentation in various formats. This means that we can start to consolidate our OFBiz documentation within OFBiz itself and adapt it to any new releases.
>
> Feedback to the proposal have been very positive and once the code is moved into our current trunk we will need to start some documentation work. We will be looking for volunteers to become part of a documentation team that will work on reviewing the documents we already have in the wiki and other sources, then help to re-structure them to fit into the new documentation framework model.
>
> Being involved with documentation is a good way to learn OFBiz :-)
>
> So if you are interested in being part of the OFBiz documentation team then please respond to this message and I will add you to the list.
>
> Thanks
> Sharan
Re: OFBiz Documentation Team Volunteers Needed
Posted by Jacques Le Roux <ja...@les7arts.com>.
Exactly, thanks for your efforts Sharan :)
Jacques
Le 14/02/2018 à 20:40, Sharan Foga a écrit :
> Hi Jacques
>
> No problem and I usually post an update for the mailing list for offline meetings and calls (because if there is no record of it on the mailing list - it didn't happen - right? :-)
>
> Thanks
> Sharan
>
> On 2018/02/14 16:45:11, Jacques Le Roux <ja...@les7arts.com> wrote:
>> Hi Sharan, Taher, All,
>>
>> Could we have a small summary of the discussion for the persons who will not be able to be present?
>>
>> Thanks
>>
>> Jacques
>>
>>
>> Le 14/02/2018 à 08:53, Sharan Foga a écrit :
>>> Hi Taher
>>>
>>> Good idea! I remember we had one to help kickstart the refactoring and it worked well.
>>>
>>> It's probably going to have to be a Hangout since Skype has stopped working for me.
>>> I will start a new thread asking our documentation team people to highlight their timezone so we can start planning for the call.
>>>
>>> Thanks
>>> Sharan
>>>
>>>
>>> On 2018/02/13 19:58:51, Taher Alkhateeb <sl...@gmail.com> wrote:
>>>> Hi Sharan, all
>>>>
>>>> There are many details to discuss and some technical issues that I need to
>>>> explain, so perhaps a skype voice conference could help kickstart this task
>>>> and get everyone on the same page?
>>>>
>>>> Cheers
>>>>
>>>> Taher Alkhateeb
>>>>
>>>> On Feb 13, 2018 1:25 PM, "Sharan Foga" <sh...@apache.org> wrote:
>>>>
>>>>> Thanks Guilio - I will add you to the list.
>>>>>
>>>>> Thanks
>>>>> Sharan
>>>>>
>>>>> On 2018/02/13 09:24:30, Giulio Speri - MpStyle Srl <
>>>>> giulio.speri@mpstyle.it> wrote:
>>>>>> Hi Sharan,
>>>>>>
>>>>>> I would like and I would be very happy to take part of this team if it's
>>>>>> not too late.
>>>>>> I'll do my best to contribute.
>>>>>>
>>>>>> Thanks very much,
>>>>>>
>>>>>> Giulio
>>>>>>
>>>>>> 2018-02-13 9:29 GMT+01:00 Sharan Foga <sh...@apache.org>:
>>>>>>
>>>>>>> Hi All
>>>>>>>
>>>>>>> Wow! – thanks everyone for such a great response.
>>>>>>>
>>>>>>> It's nice to see that we have people in the community that are ready
>>>>> and
>>>>>>> willing to help :-) And don't worry if you don't think you know very
>>>>> much
>>>>>>> – we will all learn something as part of the process. This is exactly
>>>>> what
>>>>>>> being part of a community is about!
>>>>>>>
>>>>>>> I have created a new wiki page called Documentation Team
>>>>>>>
>>>>>>> https://cwiki.apache.org/confluence/display/OFBIZ/
>>>>> OFBiz+Documentation+Team
>>>>>>> that is a little empty at the moment, but we can use it to brainstorm
>>>>>>> ideas and plan our work.
>>>>>>>
>>>>>>> One of the first things that all of you will need to do, is to ensure
>>>>> that
>>>>>>> you are setup as an OFBiz Contributor. You can find out how to do this
>>>>> at
>>>>>>> the link below:
>>>>>>>
>>>>>>> https://cwiki.apache.org/confluence/display/OFBIZ/
>>>>>>> Apache+OFBiz+Contributors
>>>>>>>
>>>>>>> So if you haven't done so already, please get an ICLA completed and
>>>>> then
>>>>>>> we be able to setup the access you will need for our wiki and also our
>>>>> Jira
>>>>>>> Issue tracking system.
>>>>>>>
>>>>>>> I'm really looking forward to working with you all.
>>>>>>>
>>>>>>> Thank
>>>>>>> Sharan
>>>>>>>
>>>>>>>
>>>>>>> On 2018/02/07 13:32:56, Sharan Foga <sh...@apache.org> wrote:
>>>>>>>> Hi Everyone
>>>>>>>>
>>>>>>>> (Trying again as my first post didn't reach this list)
>>>>>>>>
>>>>>>>> If you have read the latest project blog post then you will have
>>>>> seen a
>>>>>>> section about the discussions that have been happening on our
>>>>> development
>>>>>>> list about the new proposed OFBiz documentation framework.
>>>>>>>> https://s.apache.org/VfxE
>>>>>>>>
>>>>>>>> It is based on asciidoc and will be able to generate documentation in
>>>>>>> various formats. This means that we can start to consolidate our OFBiz
>>>>>>> documentation within OFBiz itself and adapt it to any new releases.
>>>>>>>> Feedback to the proposal have been very positive and once the code is
>>>>>>> moved into our current trunk we will need to start some documentation
>>>>> work.
>>>>>>> We will be looking for volunteers to become part of a documentation
>>>>> team
>>>>>>> that will work on reviewing the documents we already have in the wiki
>>>>> and
>>>>>>> other sources, then help to re-structure them to fit into the new
>>>>>>> documentation framework model.
>>>>>>>> Being involved with documentation is a good way to learn OFBiz :-)
>>>>>>>>
>>>>>>>> So if you are interested in being part of the OFBiz documentation
>>>>> team
>>>>>>> then please respond to this message and I will add you to the list.
>>>>>>>> Thanks
>>>>>>>> Sharan
>>>>>>>>
>>>>>>
>>>>>> --
>>>>>> Giulio Speri
>>>>>>
>>>>>> *Mp Styl**e Srl*
>>>>>> via Antonio Meucci, 37
>>>>>> 41019 Limidi di Soliera (MO)
>>>>>> T 059/684916
>>>>>> M 334/3779851
>>>>>>
>>>>>> www.mpstyle.it
>>>>>>
>>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Sharan Foga <sh...@apache.org>.
Hi Jacques
No problem and I usually post an update for the mailing list for offline meetings and calls (because if there is no record of it on the mailing list - it didn't happen - right? :-)
Thanks
Sharan
On 2018/02/14 16:45:11, Jacques Le Roux <ja...@les7arts.com> wrote:
> Hi Sharan, Taher, All,
>
> Could we have a small summary of the discussion for the persons who will not be able to be present?
>
> Thanks
>
> Jacques
>
>
> Le 14/02/2018 à 08:53, Sharan Foga a écrit :
> > Hi Taher
> >
> > Good idea! I remember we had one to help kickstart the refactoring and it worked well.
> >
> > It's probably going to have to be a Hangout since Skype has stopped working for me.
> > I will start a new thread asking our documentation team people to highlight their timezone so we can start planning for the call.
> >
> > Thanks
> > Sharan
> >
> >
> > On 2018/02/13 19:58:51, Taher Alkhateeb <sl...@gmail.com> wrote:
> >> Hi Sharan, all
> >>
> >> There are many details to discuss and some technical issues that I need to
> >> explain, so perhaps a skype voice conference could help kickstart this task
> >> and get everyone on the same page?
> >>
> >> Cheers
> >>
> >> Taher Alkhateeb
> >>
> >> On Feb 13, 2018 1:25 PM, "Sharan Foga" <sh...@apache.org> wrote:
> >>
> >>> Thanks Guilio - I will add you to the list.
> >>>
> >>> Thanks
> >>> Sharan
> >>>
> >>> On 2018/02/13 09:24:30, Giulio Speri - MpStyle Srl <
> >>> giulio.speri@mpstyle.it> wrote:
> >>>> Hi Sharan,
> >>>>
> >>>> I would like and I would be very happy to take part of this team if it's
> >>>> not too late.
> >>>> I'll do my best to contribute.
> >>>>
> >>>> Thanks very much,
> >>>>
> >>>> Giulio
> >>>>
> >>>> 2018-02-13 9:29 GMT+01:00 Sharan Foga <sh...@apache.org>:
> >>>>
> >>>>> Hi All
> >>>>>
> >>>>> Wow! ââ¬â thanks everyone for such a great response.
> >>>>>
> >>>>> It's nice to see that we have people in the community that are ready
> >>> and
> >>>>> willing to help :-) And don't worry if you don't think you know very
> >>> much
> >>>>> ââ¬â we will all learn something as part of the process. This is exactly
> >>> what
> >>>>> being part of a community is about!
> >>>>>
> >>>>> I have created a new wiki page called Documentation Team
> >>>>>
> >>>>> https://cwiki.apache.org/confluence/display/OFBIZ/
> >>> OFBiz+Documentation+Team
> >>>>> that is a little empty at the moment, but we can use it to brainstorm
> >>>>> ideas and plan our work.
> >>>>>
> >>>>> One of the first things that all of you will need to do, is to ensure
> >>> that
> >>>>> you are setup as an OFBiz Contributor. You can find out how to do this
> >>> at
> >>>>> the link below:
> >>>>>
> >>>>> https://cwiki.apache.org/confluence/display/OFBIZ/
> >>>>> Apache+OFBiz+Contributors
> >>>>>
> >>>>> So if you haven't done so already, please get an ICLA completed and
> >>> then
> >>>>> we be able to setup the access you will need for our wiki and also our
> >>> Jira
> >>>>> Issue tracking system.
> >>>>>
> >>>>> I'm really looking forward to working with you all.
> >>>>>
> >>>>> Thank
> >>>>> Sharan
> >>>>>
> >>>>>
> >>>>> On 2018/02/07 13:32:56, Sharan Foga <sh...@apache.org> wrote:
> >>>>>> Hi Everyone
> >>>>>>
> >>>>>> (Trying again as my first post didn't reach this list)
> >>>>>>
> >>>>>> If you have read the latest project blog post then you will have
> >>> seen a
> >>>>> section about the discussions that have been happening on our
> >>> development
> >>>>> list about the new proposed OFBiz documentation framework.
> >>>>>> https://s.apache.org/VfxE
> >>>>>>
> >>>>>> It is based on asciidoc and will be able to generate documentation in
> >>>>> various formats. This means that we can start to consolidate our OFBiz
> >>>>> documentation within OFBiz itself and adapt it to any new releases.
> >>>>>> Feedback to the proposal have been very positive and once the code is
> >>>>> moved into our current trunk we will need to start some documentation
> >>> work.
> >>>>> We will be looking for volunteers to become part of a documentation
> >>> team
> >>>>> that will work on reviewing the documents we already have in the wiki
> >>> and
> >>>>> other sources, then help to re-structure them to fit into the new
> >>>>> documentation framework model.
> >>>>>> Being involved with documentation is a good way to learn OFBiz :-)
> >>>>>>
> >>>>>> So if you are interested in being part of the OFBiz documentation
> >>> team
> >>>>> then please respond to this message and I will add you to the list.
> >>>>>> Thanks
> >>>>>> Sharan
> >>>>>>
> >>>>
> >>>>
> >>>> --
> >>>> Giulio Speri
> >>>>
> >>>> *Mp Styl**e Srl*
> >>>> via Antonio Meucci, 37
> >>>> 41019 Limidi di Soliera (MO)
> >>>> T 059/684916
> >>>> M 334/3779851
> >>>>
> >>>> www.mpstyle.it
> >>>>
>
>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Jacques Le Roux <ja...@les7arts.com>.
Hi Sharan, Taher, All,
Could we have a small summary of the discussion for the persons who will not be able to be present?
Thanks
Jacques
Le 14/02/2018 à 08:53, Sharan Foga a écrit :
> Hi Taher
>
> Good idea! I remember we had one to help kickstart the refactoring and it worked well.
>
> It's probably going to have to be a Hangout since Skype has stopped working for me.
> I will start a new thread asking our documentation team people to highlight their timezone so we can start planning for the call.
>
> Thanks
> Sharan
>
>
> On 2018/02/13 19:58:51, Taher Alkhateeb <sl...@gmail.com> wrote:
>> Hi Sharan, all
>>
>> There are many details to discuss and some technical issues that I need to
>> explain, so perhaps a skype voice conference could help kickstart this task
>> and get everyone on the same page?
>>
>> Cheers
>>
>> Taher Alkhateeb
>>
>> On Feb 13, 2018 1:25 PM, "Sharan Foga" <sh...@apache.org> wrote:
>>
>>> Thanks Guilio - I will add you to the list.
>>>
>>> Thanks
>>> Sharan
>>>
>>> On 2018/02/13 09:24:30, Giulio Speri - MpStyle Srl <
>>> giulio.speri@mpstyle.it> wrote:
>>>> Hi Sharan,
>>>>
>>>> I would like and I would be very happy to take part of this team if it's
>>>> not too late.
>>>> I'll do my best to contribute.
>>>>
>>>> Thanks very much,
>>>>
>>>> Giulio
>>>>
>>>> 2018-02-13 9:29 GMT+01:00 Sharan Foga <sh...@apache.org>:
>>>>
>>>>> Hi All
>>>>>
>>>>> Wow! – thanks everyone for such a great response.
>>>>>
>>>>> It's nice to see that we have people in the community that are ready
>>> and
>>>>> willing to help :-) And don't worry if you don't think you know very
>>> much
>>>>> – we will all learn something as part of the process. This is exactly
>>> what
>>>>> being part of a community is about!
>>>>>
>>>>> I have created a new wiki page called Documentation Team
>>>>>
>>>>> https://cwiki.apache.org/confluence/display/OFBIZ/
>>> OFBiz+Documentation+Team
>>>>> that is a little empty at the moment, but we can use it to brainstorm
>>>>> ideas and plan our work.
>>>>>
>>>>> One of the first things that all of you will need to do, is to ensure
>>> that
>>>>> you are setup as an OFBiz Contributor. You can find out how to do this
>>> at
>>>>> the link below:
>>>>>
>>>>> https://cwiki.apache.org/confluence/display/OFBIZ/
>>>>> Apache+OFBiz+Contributors
>>>>>
>>>>> So if you haven't done so already, please get an ICLA completed and
>>> then
>>>>> we be able to setup the access you will need for our wiki and also our
>>> Jira
>>>>> Issue tracking system.
>>>>>
>>>>> I'm really looking forward to working with you all.
>>>>>
>>>>> Thank
>>>>> Sharan
>>>>>
>>>>>
>>>>> On 2018/02/07 13:32:56, Sharan Foga <sh...@apache.org> wrote:
>>>>>> Hi Everyone
>>>>>>
>>>>>> (Trying again as my first post didn't reach this list)
>>>>>>
>>>>>> If you have read the latest project blog post then you will have
>>> seen a
>>>>> section about the discussions that have been happening on our
>>> development
>>>>> list about the new proposed OFBiz documentation framework.
>>>>>> https://s.apache.org/VfxE
>>>>>>
>>>>>> It is based on asciidoc and will be able to generate documentation in
>>>>> various formats. This means that we can start to consolidate our OFBiz
>>>>> documentation within OFBiz itself and adapt it to any new releases.
>>>>>> Feedback to the proposal have been very positive and once the code is
>>>>> moved into our current trunk we will need to start some documentation
>>> work.
>>>>> We will be looking for volunteers to become part of a documentation
>>> team
>>>>> that will work on reviewing the documents we already have in the wiki
>>> and
>>>>> other sources, then help to re-structure them to fit into the new
>>>>> documentation framework model.
>>>>>> Being involved with documentation is a good way to learn OFBiz :-)
>>>>>>
>>>>>> So if you are interested in being part of the OFBiz documentation
>>> team
>>>>> then please respond to this message and I will add you to the list.
>>>>>> Thanks
>>>>>> Sharan
>>>>>>
>>>>
>>>>
>>>> --
>>>> Giulio Speri
>>>>
>>>> *Mp Styl**e Srl*
>>>> via Antonio Meucci, 37
>>>> 41019 Limidi di Soliera (MO)
>>>> T 059/684916
>>>> M 334/3779851
>>>>
>>>> www.mpstyle.it
>>>>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Sharan Foga <sh...@apache.org>.
Hi Taher
Good idea! I remember we had one to help kickstart the refactoring and it worked well.
It's probably going to have to be a Hangout since Skype has stopped working for me.
I will start a new thread asking our documentation team people to highlight their timezone so we can start planning for the call.
Thanks
Sharan
On 2018/02/13 19:58:51, Taher Alkhateeb <sl...@gmail.com> wrote:
> Hi Sharan, all
>
> There are many details to discuss and some technical issues that I need to
> explain, so perhaps a skype voice conference could help kickstart this task
> and get everyone on the same page?
>
> Cheers
>
> Taher Alkhateeb
>
> On Feb 13, 2018 1:25 PM, "Sharan Foga" <sh...@apache.org> wrote:
>
> > Thanks Guilio - I will add you to the list.
> >
> > Thanks
> > Sharan
> >
> > On 2018/02/13 09:24:30, Giulio Speri - MpStyle Srl <
> > giulio.speri@mpstyle.it> wrote:
> > > Hi Sharan,
> > >
> > > I would like and I would be very happy to take part of this team if it's
> > > not too late.
> > > I'll do my best to contribute.
> > >
> > > Thanks very much,
> > >
> > > Giulio
> > >
> > > 2018-02-13 9:29 GMT+01:00 Sharan Foga <sh...@apache.org>:
> > >
> > > > Hi All
> > > >
> > > > Wow! â thanks everyone for such a great response.
> > > >
> > > > It's nice to see that we have people in the community that are ready
> > and
> > > > willing to help :-) And don't worry if you don't think you know very
> > much
> > > > â we will all learn something as part of the process. This is exactly
> > what
> > > > being part of a community is about!
> > > >
> > > > I have created a new wiki page called Documentation Team
> > > >
> > > > https://cwiki.apache.org/confluence/display/OFBIZ/
> > OFBiz+Documentation+Team
> > > >
> > > > that is a little empty at the moment, but we can use it to brainstorm
> > > > ideas and plan our work.
> > > >
> > > > One of the first things that all of you will need to do, is to ensure
> > that
> > > > you are setup as an OFBiz Contributor. You can find out how to do this
> > at
> > > > the link below:
> > > >
> > > > https://cwiki.apache.org/confluence/display/OFBIZ/
> > > > Apache+OFBiz+Contributors
> > > >
> > > > So if you haven't done so already, please get an ICLA completed and
> > then
> > > > we be able to setup the access you will need for our wiki and also our
> > Jira
> > > > Issue tracking system.
> > > >
> > > > I'm really looking forward to working with you all.
> > > >
> > > > Thank
> > > > Sharan
> > > >
> > > >
> > > > On 2018/02/07 13:32:56, Sharan Foga <sh...@apache.org> wrote:
> > > > > Hi Everyone
> > > > >
> > > > > (Trying again as my first post didn't reach this list)
> > > > >
> > > > > If you have read the latest project blog post then you will have
> > seen a
> > > > section about the discussions that have been happening on our
> > development
> > > > list about the new proposed OFBiz documentation framework.
> > > > >
> > > > > https://s.apache.org/VfxE
> > > > >
> > > > > It is based on asciidoc and will be able to generate documentation in
> > > > various formats. This means that we can start to consolidate our OFBiz
> > > > documentation within OFBiz itself and adapt it to any new releases.
> > > > >
> > > > > Feedback to the proposal have been very positive and once the code is
> > > > moved into our current trunk we will need to start some documentation
> > work.
> > > > We will be looking for volunteers to become part of a documentation
> > team
> > > > that will work on reviewing the documents we already have in the wiki
> > and
> > > > other sources, then help to re-structure them to fit into the new
> > > > documentation framework model.
> > > > >
> > > > > Being involved with documentation is a good way to learn OFBiz :-)
> > > > >
> > > > > So if you are interested in being part of the OFBiz documentation
> > team
> > > > then please respond to this message and I will add you to the list.
> > > > >
> > > > > Thanks
> > > > > Sharan
> > > > >
> > > >
> > >
> > >
> > >
> > > --
> > > Giulio Speri
> > >
> > > *Mp Styl**e Srl*
> > > via Antonio Meucci, 37
> > > 41019 Limidi di Soliera (MO)
> > > T 059/684916
> > > M 334/3779851
> > >
> > > www.mpstyle.it
> > >
> >
>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Taher Alkhateeb <sl...@gmail.com>.
Hi Sharan, all
There are many details to discuss and some technical issues that I need to
explain, so perhaps a skype voice conference could help kickstart this task
and get everyone on the same page?
Cheers
Taher Alkhateeb
On Feb 13, 2018 1:25 PM, "Sharan Foga" <sh...@apache.org> wrote:
> Thanks Guilio - I will add you to the list.
>
> Thanks
> Sharan
>
> On 2018/02/13 09:24:30, Giulio Speri - MpStyle Srl <
> giulio.speri@mpstyle.it> wrote:
> > Hi Sharan,
> >
> > I would like and I would be very happy to take part of this team if it's
> > not too late.
> > I'll do my best to contribute.
> >
> > Thanks very much,
> >
> > Giulio
> >
> > 2018-02-13 9:29 GMT+01:00 Sharan Foga <sh...@apache.org>:
> >
> > > Hi All
> > >
> > > Wow! – thanks everyone for such a great response.
> > >
> > > It's nice to see that we have people in the community that are ready
> and
> > > willing to help :-) And don't worry if you don't think you know very
> much
> > > – we will all learn something as part of the process. This is exactly
> what
> > > being part of a community is about!
> > >
> > > I have created a new wiki page called Documentation Team
> > >
> > > https://cwiki.apache.org/confluence/display/OFBIZ/
> OFBiz+Documentation+Team
> > >
> > > that is a little empty at the moment, but we can use it to brainstorm
> > > ideas and plan our work.
> > >
> > > One of the first things that all of you will need to do, is to ensure
> that
> > > you are setup as an OFBiz Contributor. You can find out how to do this
> at
> > > the link below:
> > >
> > > https://cwiki.apache.org/confluence/display/OFBIZ/
> > > Apache+OFBiz+Contributors
> > >
> > > So if you haven't done so already, please get an ICLA completed and
> then
> > > we be able to setup the access you will need for our wiki and also our
> Jira
> > > Issue tracking system.
> > >
> > > I'm really looking forward to working with you all.
> > >
> > > Thank
> > > Sharan
> > >
> > >
> > > On 2018/02/07 13:32:56, Sharan Foga <sh...@apache.org> wrote:
> > > > Hi Everyone
> > > >
> > > > (Trying again as my first post didn't reach this list)
> > > >
> > > > If you have read the latest project blog post then you will have
> seen a
> > > section about the discussions that have been happening on our
> development
> > > list about the new proposed OFBiz documentation framework.
> > > >
> > > > https://s.apache.org/VfxE
> > > >
> > > > It is based on asciidoc and will be able to generate documentation in
> > > various formats. This means that we can start to consolidate our OFBiz
> > > documentation within OFBiz itself and adapt it to any new releases.
> > > >
> > > > Feedback to the proposal have been very positive and once the code is
> > > moved into our current trunk we will need to start some documentation
> work.
> > > We will be looking for volunteers to become part of a documentation
> team
> > > that will work on reviewing the documents we already have in the wiki
> and
> > > other sources, then help to re-structure them to fit into the new
> > > documentation framework model.
> > > >
> > > > Being involved with documentation is a good way to learn OFBiz :-)
> > > >
> > > > So if you are interested in being part of the OFBiz documentation
> team
> > > then please respond to this message and I will add you to the list.
> > > >
> > > > Thanks
> > > > Sharan
> > > >
> > >
> >
> >
> >
> > --
> > Giulio Speri
> >
> > *Mp Styl**e Srl*
> > via Antonio Meucci, 37
> > 41019 Limidi di Soliera (MO)
> > T 059/684916
> > M 334/3779851
> >
> > www.mpstyle.it
> >
>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Sharan Foga <sh...@apache.org>.
Thanks Guilio - I will add you to the list.
Thanks
Sharan
On 2018/02/13 09:24:30, Giulio Speri - MpStyle Srl <gi...@mpstyle.it> wrote:
> Hi Sharan,
>
> I would like and I would be very happy to take part of this team if it's
> not too late.
> I'll do my best to contribute.
>
> Thanks very much,
>
> Giulio
>
> 2018-02-13 9:29 GMT+01:00 Sharan Foga <sh...@apache.org>:
>
> > Hi All
> >
> > Wow! â thanks everyone for such a great response.
> >
> > It's nice to see that we have people in the community that are ready and
> > willing to help :-) And don't worry if you don't think you know very much
> > â we will all learn something as part of the process. This is exactly what
> > being part of a community is about!
> >
> > I have created a new wiki page called Documentation Team
> >
> > https://cwiki.apache.org/confluence/display/OFBIZ/OFBiz+Documentation+Team
> >
> > that is a little empty at the moment, but we can use it to brainstorm
> > ideas and plan our work.
> >
> > One of the first things that all of you will need to do, is to ensure that
> > you are setup as an OFBiz Contributor. You can find out how to do this at
> > the link below:
> >
> > https://cwiki.apache.org/confluence/display/OFBIZ/
> > Apache+OFBiz+Contributors
> >
> > So if you haven't done so already, please get an ICLA completed and then
> > we be able to setup the access you will need for our wiki and also our Jira
> > Issue tracking system.
> >
> > I'm really looking forward to working with you all.
> >
> > Thank
> > Sharan
> >
> >
> > On 2018/02/07 13:32:56, Sharan Foga <sh...@apache.org> wrote:
> > > Hi Everyone
> > >
> > > (Trying again as my first post didn't reach this list)
> > >
> > > If you have read the latest project blog post then you will have seen a
> > section about the discussions that have been happening on our development
> > list about the new proposed OFBiz documentation framework.
> > >
> > > https://s.apache.org/VfxE
> > >
> > > It is based on asciidoc and will be able to generate documentation in
> > various formats. This means that we can start to consolidate our OFBiz
> > documentation within OFBiz itself and adapt it to any new releases.
> > >
> > > Feedback to the proposal have been very positive and once the code is
> > moved into our current trunk we will need to start some documentation work.
> > We will be looking for volunteers to become part of a documentation team
> > that will work on reviewing the documents we already have in the wiki and
> > other sources, then help to re-structure them to fit into the new
> > documentation framework model.
> > >
> > > Being involved with documentation is a good way to learn OFBiz :-)
> > >
> > > So if you are interested in being part of the OFBiz documentation team
> > then please respond to this message and I will add you to the list.
> > >
> > > Thanks
> > > Sharan
> > >
> >
>
>
>
> --
> Giulio Speri
>
> *Mp Styl**e Srl*
> via Antonio Meucci, 37
> 41019 Limidi di Soliera (MO)
> T 059/684916
> M 334/3779851
>
> www.mpstyle.it
>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Giulio Speri - MpStyle Srl <gi...@mpstyle.it>.
Hi Sharan,
I would like and I would be very happy to take part of this team if it's
not too late.
I'll do my best to contribute.
Thanks very much,
Giulio
2018-02-13 9:29 GMT+01:00 Sharan Foga <sh...@apache.org>:
> Hi All
>
> Wow! – thanks everyone for such a great response.
>
> It's nice to see that we have people in the community that are ready and
> willing to help :-) And don't worry if you don't think you know very much
> – we will all learn something as part of the process. This is exactly what
> being part of a community is about!
>
> I have created a new wiki page called Documentation Team
>
> https://cwiki.apache.org/confluence/display/OFBIZ/OFBiz+Documentation+Team
>
> that is a little empty at the moment, but we can use it to brainstorm
> ideas and plan our work.
>
> One of the first things that all of you will need to do, is to ensure that
> you are setup as an OFBiz Contributor. You can find out how to do this at
> the link below:
>
> https://cwiki.apache.org/confluence/display/OFBIZ/
> Apache+OFBiz+Contributors
>
> So if you haven't done so already, please get an ICLA completed and then
> we be able to setup the access you will need for our wiki and also our Jira
> Issue tracking system.
>
> I'm really looking forward to working with you all.
>
> Thank
> Sharan
>
>
> On 2018/02/07 13:32:56, Sharan Foga <sh...@apache.org> wrote:
> > Hi Everyone
> >
> > (Trying again as my first post didn't reach this list)
> >
> > If you have read the latest project blog post then you will have seen a
> section about the discussions that have been happening on our development
> list about the new proposed OFBiz documentation framework.
> >
> > https://s.apache.org/VfxE
> >
> > It is based on asciidoc and will be able to generate documentation in
> various formats. This means that we can start to consolidate our OFBiz
> documentation within OFBiz itself and adapt it to any new releases.
> >
> > Feedback to the proposal have been very positive and once the code is
> moved into our current trunk we will need to start some documentation work.
> We will be looking for volunteers to become part of a documentation team
> that will work on reviewing the documents we already have in the wiki and
> other sources, then help to re-structure them to fit into the new
> documentation framework model.
> >
> > Being involved with documentation is a good way to learn OFBiz :-)
> >
> > So if you are interested in being part of the OFBiz documentation team
> then please respond to this message and I will add you to the list.
> >
> > Thanks
> > Sharan
> >
>
--
Giulio Speri
*Mp Styl**e Srl*
via Antonio Meucci, 37
41019 Limidi di Soliera (MO)
T 059/684916
M 334/3779851
www.mpstyle.it
Re: OFBiz Documentation Team Volunteers Needed
Posted by Sharan Foga <sh...@apache.org>.
Hi All
Wow! â thanks everyone for such a great response.
It's nice to see that we have people in the community that are ready and willing to help :-) And don't worry if you don't think you know very much â we will all learn something as part of the process. This is exactly what being part of a community is about!
I have created a new wiki page called Documentation Team
https://cwiki.apache.org/confluence/display/OFBIZ/OFBiz+Documentation+Team
that is a little empty at the moment, but we can use it to brainstorm ideas and plan our work.
One of the first things that all of you will need to do, is to ensure that you are setup as an OFBiz Contributor. You can find out how to do this at the link below:
https://cwiki.apache.org/confluence/display/OFBIZ/Apache+OFBiz+Contributors
So if you haven't done so already, please get an ICLA completed and then we be able to setup the access you will need for our wiki and also our Jira Issue tracking system.
I'm really looking forward to working with you all.
Thank
Sharan
On 2018/02/07 13:32:56, Sharan Foga <sh...@apache.org> wrote:
> Hi Everyone
>
> (Trying again as my first post didn't reach this list)
>
> If you have read the latest project blog post then you will have seen a section about the discussions that have been happening on our development list about the new proposed OFBiz documentation framework.
>
> https://s.apache.org/VfxE
>
> It is based on asciidoc and will be able to generate documentation in various formats. This means that we can start to consolidate our OFBiz documentation within OFBiz itself and adapt it to any new releases.
>
> Feedback to the proposal have been very positive and once the code is moved into our current trunk we will need to start some documentation work. We will be looking for volunteers to become part of a documentation team that will work on reviewing the documents we already have in the wiki and other sources, then help to re-structure them to fit into the new documentation framework model.
>
> Being involved with documentation is a good way to learn OFBiz :-)
>
> So if you are interested in being part of the OFBiz documentation team then please respond to this message and I will add you to the list.
>
> Thanks
> Sharan
>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Tarun Thakur <ta...@karyonsolutions.com>.
Hello Sharan,
Want to join in too. Don't have that much of OFBiz experience but can be
helpful with my Oracle POS & Retail knowledge here. Please consider my
request.
*Thanks & Regards*,
[image: Inline image 2]
*Tarun Singh Thakur *| *Business Development Representative*
Mobile: +91-8826544218
www.*karyonsolutions*.com | *Building the Nucleus*
On Fri, Feb 9, 2018 at 10:02 AM, Akash Jain <ak...@hotwaxsystems.com>
wrote:
> Hi Sharan,
>
> Please count me in.
>
> Thanks and Regards
> --
> Akash Jain
>
> On Wed, Feb 7, 2018 at 7:02 PM, Sharan Foga <sh...@apache.org> wrote:
>
> > Hi Everyone
> >
> > (Trying again as my first post didn't reach this list)
> >
> > If you have read the latest project blog post then you will have seen a
> > section about the discussions that have been happening on our development
> > list about the new proposed OFBiz documentation framework.
> >
> > https://s.apache.org/VfxE
> >
> > It is based on asciidoc and will be able to generate documentation in
> > various formats. This means that we can start to consolidate our OFBiz
> > documentation within OFBiz itself and adapt it to any new releases.
> >
> > Feedback to the proposal have been very positive and once the code is
> > moved into our current trunk we will need to start some documentation
> work.
> > We will be looking for volunteers to become part of a documentation team
> > that will work on reviewing the documents we already have in the wiki and
> > other sources, then help to re-structure them to fit into the new
> > documentation framework model.
> >
> > Being involved with documentation is a good way to learn OFBiz :-)
> >
> > So if you are interested in being part of the OFBiz documentation team
> > then please respond to this message and I will add you to the list.
> >
> > Thanks
> > Sharan
> >
>
Re: OFBiz Documentation Team Volunteers Needed
Posted by Akash Jain <ak...@hotwaxsystems.com>.
Hi Sharan,
Please count me in.
Thanks and Regards
--
Akash Jain
On Wed, Feb 7, 2018 at 7:02 PM, Sharan Foga <sh...@apache.org> wrote:
> Hi Everyone
>
> (Trying again as my first post didn't reach this list)
>
> If you have read the latest project blog post then you will have seen a
> section about the discussions that have been happening on our development
> list about the new proposed OFBiz documentation framework.
>
> https://s.apache.org/VfxE
>
> It is based on asciidoc and will be able to generate documentation in
> various formats. This means that we can start to consolidate our OFBiz
> documentation within OFBiz itself and adapt it to any new releases.
>
> Feedback to the proposal have been very positive and once the code is
> moved into our current trunk we will need to start some documentation work.
> We will be looking for volunteers to become part of a documentation team
> that will work on reviewing the documents we already have in the wiki and
> other sources, then help to re-structure them to fit into the new
> documentation framework model.
>
> Being involved with documentation is a good way to learn OFBiz :-)
>
> So if you are interested in being part of the OFBiz documentation team
> then please respond to this message and I will add you to the list.
>
> Thanks
> Sharan
>