OFBiz Documentation Team Volunteers Needed

[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

[deepak nigam]

Hi Sharan,

Please consider me in.

Thanks & Regard
--
Deepak Nigam

On Feb 7, 2018 7:02 PM, "Sharan Foga"  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

[Arthur Marquez]

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/ *



On Wed, Feb 7, 2018 at 6:32 AM, Sharan Foga  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

[Swapnil Mane]

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  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

[Michael Brohl]

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





smime.p7s
Description: S/MIME Cryptographic Signature

Re: OFBiz Documentation Team Volunteers Needed

[Pranay Pandey]

Hi Sharan,

Please count me in.

Best regards,

Pranay Pandey
www.hotwax.co

On Thu, Feb 8, 2018 at 1:59 PM, Michael Brohl 
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

[Pranay Pandey]

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 
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

[Olivier Heintz]

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

[Aditya Sharma]

Hi Sharan,

Please count me in.

Thanks and Regards,

*Aditya Sharma* | Enterprise Software Engineer
HotWax Commerce  by HotWax Systems




On Thu, Feb 8, 2018 at 2:25 PM, Olivier Heintz <
holivier.li...@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

[Jacques Le Roux]

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

[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
 wrote:
> Hi Sharan,
>
> Please count me in.
>
> Thanks and Regards,
>
> *Aditya Sharma* | Enterprise Software Engineer
> HotWax Commerce  by HotWax Systems
> 
>
> 
>
> On Thu, Feb 8, 2018 at 2:25 PM, Olivier Heintz <
> holivier.li...@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

[Michael Brohl]

+++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
 wrote:

Hi Sharan,

Please count me in.

Thanks and Regards,

*Aditya Sharma* | Enterprise Software Engineer
HotWax Commerce  by HotWax Systems




On Thu, Feb 8, 2018 at 2:25 PM, Olivier Heintz <
holivier.li...@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








smime.p7s
Description: S/MIME Cryptographic Signature

Re: OFBiz Documentation Team Volunteers Needed

[Dennis Balkir]

Hi Sharan,

please add me to the list.

Thanks
Dennis Balkir

On 2018/02/07 13:32:56, Sharan Foga  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> 
>  


-- 
Dennis Balkir
Trainee

Fon +49 521 448 157-90
Fax +49 521 448 157-99

Company and Management Headquarters:
ecomify GmbH, Gustav-Winkler-Str. 22, 33699 Bielefeld, Deutschland
Fon: +49 521 448157-90, Fax: +49 521 448157-99, www.ecomify.de

Court Registration: Amtsgericht Bielefeld HRB 41683
Chief Executive Officer: Martin Becker, Michael Brohl

Re: OFBiz Documentation Team Volunteers Needed

[Jacques Le Roux]

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
 wrote:

Hi Sharan,

Please count me in.

Thanks and Regards,

*Aditya Sharma* | Enterprise Software Engineer
HotWax Commerce  by HotWax Systems




On Thu, Feb 8, 2018 at 2:25 PM, Olivier Heintz <
holivier.li...@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

[Jacques Le Roux]

Hi Dennis,

Someone moderated your email, please subscribe to the user ML

Thanks

Jacques


Le 08/02/2018 à 15:03, Dennis Balkir a écrit :

Hi Sharan,

please add me to the list.

Thanks
Dennis Balkir

On 2018/02/07 13:32:56, Sharan Foga  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

[Dennis Balkir]

Hi Jacques,

I actually did after sending the mail

Sorry for the inconvenience!

Thanks
Dennis

On 2018/02/08 14:46:02, Jacques Le Roux  wrote: 
> Hi Dennis,> 
> 
> Someone moderated your email, please subscribe to the user ML> 
> 
> Thanks> 
> 
> Jacques> 
> 
> 
> Le 08/02/2018 à 15:03, Dennis Balkir a écrit :> 
> > Hi Sharan,> 
> >> 
> > please add me to the list.> 
> >> 
> > Thanks> 
> > Dennis Balkir> 
> >> 
> > On 2018/02/07 13:32:56, Sharan Foga  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>> 
> >>   > 
> >> 
> 
>  


-- 
Dennis Balkir
Trainee

Fon +49 521 448 157-90
Fax +49 521 448 157-99

Company and Management Headquarters:
ecomify GmbH, Gustav-Winkler-Str. 22, 33699 Bielefeld, Deutschland
Fon: +49 521 448157-90, Fax: +49 521 448157-99, www.ecomify.de

Court Registration: Amtsgericht Bielefeld HRB 41683
Chief Executive Officer: Martin Becker, Michael Brohl

Re: OFBiz Documentation Team Volunteers Needed

[Piotr Walesiak]

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"  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

[Akash Jain]

Hi Sharan,

Please count me in.

Thanks and Regards
--
Akash Jain

On Wed, Feb 7, 2018 at 7:02 PM, Sharan Foga  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

[Tarun Thakur]

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 
wrote:

> Hi Sharan,
>
> Please count me in.
>
> Thanks and Regards
> --
> Akash Jain
>
> On Wed, Feb 7, 2018 at 7:02 PM, Sharan Foga  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

[Olivier Heintz]

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
>>  wrote:
>>> Hi Sharan,
>>>
>>> Please count me in.
>>>
>>> Thanks and Regards,
>>>
>>> *Aditya Sharma* | Enterprise Software Engineer
>>> HotWax Commerce  by HotWax Systems
>>> 
>>>
>>> 
>>>
>>> On Thu, Feb 8, 2018 at 2:25 PM, Olivier Heintz <
>>> holivier.li...@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

[Jacques Le Roux]

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
 wrote:

Hi Sharan,

Please count me in.

Thanks and Regards,

*Aditya Sharma* | Enterprise Software Engineer
HotWax Commerce  by HotWax Systems




On Thu, Feb 8, 2018 at 2:25 PM, Olivier Heintz <
holivier.li...@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 wi

Re: OFBiz Documentation Team Volunteers Needed

[Jacques Le Roux]

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
  wrote:

Hi Sharan,

Please count me in.

Thanks and Regards,

*Aditya Sharma* | Enterprise Software Engineer
HotWax Commerce  by HotWax Systems




On Thu, Feb 8, 2018 at 2:25 PM, Olivier Heintz <
holivier.li...@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 conv

Re: OFBiz Documentation Team Volunteers Needed

[Sharan Foga]

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  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

[Giulio Speri - MpStyle Srl]

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 :

> 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  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

[Sharan Foga]

Thanks Guilio - I will add you to the list.

Thanks
Sharan

On 2018/02/13 09:24:30, Giulio Speri - MpStyle Srl  
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 :
> 
> > 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  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

[Taher Alkhateeb]

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"  wrote:

> Thanks Guilio - I will add you to the list.
>
> Thanks
> Sharan
>
> On 2018/02/13 09:24:30, Giulio Speri - MpStyle Srl <
> giulio.sp...@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 :
> >
> > > 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  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

[Sharan Foga]

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  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"  wrote:
> 
> > Thanks Guilio - I will add you to the list.
> >
> > Thanks
> > Sharan
> >
> > On 2018/02/13 09:24:30, Giulio Speri - MpStyle Srl <
> > giulio.sp...@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 :
> > >
> > > > 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  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

[Jacques Le Roux]

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  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"  wrote:


Thanks Guilio - I will add you to the list.

Thanks
Sharan

On 2018/02/13 09:24:30, Giulio Speri - MpStyle Srl <
giulio.sp...@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 :


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  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

[Sharan Foga]

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  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  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"  wrote:
> >>
> >>> Thanks Guilio - I will add you to the list.
> >>>
> >>> Thanks
> >>> Sharan
> >>>
> >>> On 2018/02/13 09:24:30, Giulio Speri - MpStyle Srl <
> >>> giulio.sp...@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 :
> 
> > 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  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

[Jacques Le Roux]

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  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  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"  wrote:


Thanks Guilio - I will add you to the list.

Thanks
Sharan

On 2018/02/13 09:24:30, Giulio Speri - MpStyle Srl <
giulio.sp...@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 :


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  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

[MODERATE EMAIL] Re: OFBiz Documentation Team Volunteers Needed

[Deepak Dixit]

Hi Rebecca Johnson,

Your email has been moderated, Please subscribe mailing list
http://ofbiz.apache.org/mailing-lists.html

Thanks & Regards
--
Deepak Dixit
www.hotwaxsystems.com
www.hotwax.co


-- Forwarded message --
From: Rebecca Johnson 
To: "user@ofbiz.apache.org" 
Cc:
Bcc:
Date: Fri, 16 Mar 2018 05:48:06 +
Subject: Re: OFBiz Documentation Team Volunteers Needed
Count me in.

On 2018/02/08 10:04:57, Aditya Sharma  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.li...@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: [MODERATE EMAIL] Re: OFBiz Documentation Team Volunteers Needed

[Sharan Foga]

Hi Rebecca

Welcome to our community!  Thank you for being interested in helping out with 
our documentation effort and I'll add you to the documentation team list. We 
have a wiki page setup at the link below

https://cwiki.apache.org/confluence/display/OFBIZ/OFBiz+Documentation+Team

So please take a look through it and come back with any questions.

BTW if you are still having issues with your installation, please give us more 
details so that we can help you. (Which version of OFBiz, What you process you 
used to install etc)

Thanks
Sharan


On 2018/03/16 06:22:03, Deepak Dixit  wrote: 
> Hi Rebecca Johnson,
> 
> Your email has been moderated, Please subscribe mailing list
> http://ofbiz.apache.org/mailing-lists.html
> 
> Thanks & Regards
> --
> Deepak Dixit
> www.hotwaxsystems.com
> www.hotwax.co
> 
> 
> -- Forwarded message --
> From: Rebecca Johnson 
> To: "user@ofbiz.apache.org" 
> Cc:
> Bcc:
> Date: Fri, 16 Mar 2018 05:48:06 +
> Subject: Re: OFBiz Documentation Team Volunteers Needed
> Count me in.
> 
> On 2018/02/08 10:04:57, Aditya Sharma  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.li...@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: [MODERATE EMAIL] Re: OFBiz Documentation Team Volunteers Needed

[Daniel Kapeleti]

Hi Sharan,

your email got lost in myriad of others received from this forum. You 
asked for the exact installation steps (that went wrong) and here they are:

Install Java:

(referencing these instructions: 
http://uniqueminds.co/manually-install-oracle-java-8-ubuntu/)

On your Desktop computer first do this:

Go to: http://www.oracle.com/technetwork/java/javase/downloads/index.html

Click the Java SE 8u161/ 8u162 link
In the Java SE Development Kit 8u162 section choose Accept License Agreement
Choose the Linux x64 link (jdk-8u162-linux-x64.tar.gz) and download it
Copy the download link (in Chrome press Ctrl-j, then copy download link)

In the terminal of your server do this:

wget "link-of-the-download-from-above"

mkdir /opt/jdk
tar -zxf jdk-8u162-linux-x64.tar.gz -C /opt/jdk

verify files are in the location:
ls /opt/jdk

In our case, the java executable is located under 
/opt/jdk/jdk1.8.0_162/bin/java. To set it as the default JVM in your 
machine run:

update-alternatives --install /usr/bin/java java 
/opt/jdk/jdk1.8.0_162/bin/java 100

and

update-alternatives --install /usr/bin/javac javac 
/opt/jdk/jdk1.8.0_162/bin/javac 100

Verifying installation:

java -version

The output should look like this:

java version "1.8.0_162" Java(TM) SE Runtime Environment (build 
1.8.0_162-b13) Java HotSpot(TM) 64-Bit Server VM (build 25.5-b02, mixed 
mode)

Edit Java environment variable:

nano ~/.bashrc

copy the following text at end of file:

export JAVA_HOME=/usr/lib/jvm/java-8-oracle

Download latest Ofbiz files from https://www-us.apache.org/dist/ofbiz/ 
(On the download section of the website the download was blank and it 
didn't work for me http://ofbiz.apache.org/download.html)

wget https://www-us.apache.org/dist/ofbiz/apache-ofbiz-16.11.04.zip

Verify download:

md5sum apache-ofbiz-16.11.04.zip

Should match the Md5 sum at: 
https://www-us.apache.org/dist/ofbiz/apache-ofbiz-16.11.04.zip.md5

Install unzip:

sudo apt update && sudo apt install unzip

Unzip archive:

unzip apache-ofbiz-16.11.04.zip

Install Ofbiz

cd /usr/local/apache-ofbiz
./gradlew cleanAll loadDefault

Start Ofbiz:

./gradlew ofbiz

The process will take a minute or two, then will stop Building at 91%, 
this is normal, now it is ready

To access the install go to following address:

https://[IP Address or domain]:8443/myportal/control/main
Admin Username: admin
Admin Password: ofbiz


On 2018/03/16 10:02:11, Sharan Foga  wrote:
 > Hi Rebecca>
 >
 > Welcome to our community! Thank you for being interested in helping 
out with our documentation effort and I'll add you to the documentation 
team list. We have a wiki page setup at the link below>
 >
 > 
https://cwiki.apache.org/confluence/display/OFBIZ/OFBiz+Documentation+Team>
 >
 > So please take a look through it and come back with any questions.>
 >
 > BTW if you are still having issues with your installation, please 
give us more details so that we can help you. (Which version of OFBiz, 
What you process you used to install etc)>
 >
 > Thanks>
 > Sharan>
 >
 >
 > On 2018/03/16 06:22:03, Deepak Dixit  wrote: >
 > > Hi Rebecca Johnson,>
 > > >
 > > Your email has been moderated, Please subscribe mailing list>
 > > http://ofbiz.apache.org/mailing-lists.html>
 > > >
 > > Thanks & Regards>
 > > -->
 > > Deepak Dixit>
 > > www.hotwaxsystems.com>
 > > www.hotwax.co>
 > > >
 > > >
 > > -- Forwarded message -->
 > > From: Rebecca Johnson >
 > > To: "user@ofbiz.apache.org" >
 > > Cc:>
 > > Bcc:>
 > > Date: Fri, 16 Mar 2018 05:48:06 +>
 > > Subject: Re: OFBiz Documentation Team Volunteers Needed>
 > > Count me in.>
 > > >
 > > On 2018/02/08 10:04:57, Aditya Sharma  
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.li...@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>
 &