You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ofbiz.apache.org by Pawan Verma <pa...@hotwaxsystems.com> on 2020/07/14 13:38:41 UTC
API Reference on OFBiz site
Hello Devs,
Since Oliver has refactored documentation with new directories structure
with the trunk, next and stable API Reference link becomes stale.
Question: What should be the API Reference link on the site?
Possible Solutions:
#1: We can use the link for stable APIs for Site as suggested by Jacques on
Jira OFBIZ-11888.
#2: We can show the link for both trunk and stable release like Build and
Run section.
Example:
* OFBiz API Reference*
- *Trunk API Reference*
- *Release 17.12 API Reference*
Please share your thoughts on this. TIA!
--
Thanks & Regards
Pawan Verma
Technical Consultant
*HotWax Systems*
*Enterprise open source experts*
http://www.hotwaxsystems.com
Re: API Reference on OFBiz site
Posted by Jacques Le Roux <ja...@les7arts.com>.
Hi Pawan,
That looks good but we have a problem with the menu Documentation/API Reference
Jacques
Le 16/07/2020 à 14:12, Pritam Kute a écrit :
> Thanks, Pawan. Looks good to me.
>
> Kind Regards,
> --
> Pritam Kute
>
>
> On Thu, Jul 16, 2020 at 5:24 PM Devanshu Vyas <vy...@gmail.com>
> wrote:
>
>> Looks good to me.👍
>>
>> Thanks & Regards,
>> Devanshu Vyas.
>>
>>
>> On Thu, Jul 16, 2020 at 4:42 PM Pawan Verma <pawan.verma@hotwaxsystems.com
>> wrote:
>>
>>> Changes are live now, please have a look at
>>> https://ofbiz.apache.org/developers.html#DevDocs
>>>
>>> If we are good here the ticket can be closed now.
>>> --
>>> Thanks & Regards
>>> Pawan Verma
>>> Technical Consultant
>>> *HotWax Systems*
>>> *Enterprise open source experts*
>>> http://www.hotwaxsystems.com
>>>
>>>
>>> On Thu, Jul 16, 2020 at 3:26 PM Jacques Le Roux <
>>> jacques.le.roux@les7arts.com> wrote:
>>>
>>>> +1
>>>>
>>>> Jacques
>>>>
>>>> Le 16/07/2020 à 11:43, Pawan Verma a écrit :
>>>>> Thanks, Jacques, All for the response.
>>>>>
>>>>> Yes, Makes sense. So, It will look something like this, if this looks
>>>> good,
>>>>> I'll make the required changes.
>>>>>
>>>>> The layout of API Reference on the Site:
>>>>> *OFBiz API Reference*
>>>>>
>>>>> - *Trunk API Reference*
>>>>> - *Release 17.12 API Reference*
>>>>> - *Next Release API Reference*
>>>>>
Re: API Reference on OFBiz site
Posted by Pritam Kute <pr...@hotwaxsystems.com>.
Thanks, Pawan. Looks good to me.
Kind Regards,
--
Pritam Kute
On Thu, Jul 16, 2020 at 5:24 PM Devanshu Vyas <vy...@gmail.com>
wrote:
> Looks good to me.👍
>
> Thanks & Regards,
> Devanshu Vyas.
>
>
> On Thu, Jul 16, 2020 at 4:42 PM Pawan Verma <pawan.verma@hotwaxsystems.com
> >
> wrote:
>
> > Changes are live now, please have a look at
> > https://ofbiz.apache.org/developers.html#DevDocs
> >
> > If we are good here the ticket can be closed now.
> > --
> > Thanks & Regards
> > Pawan Verma
> > Technical Consultant
> > *HotWax Systems*
> > *Enterprise open source experts*
> > http://www.hotwaxsystems.com
> >
> >
> > On Thu, Jul 16, 2020 at 3:26 PM Jacques Le Roux <
> > jacques.le.roux@les7arts.com> wrote:
> >
> > > +1
> > >
> > > Jacques
> > >
> > > Le 16/07/2020 à 11:43, Pawan Verma a écrit :
> > > > Thanks, Jacques, All for the response.
> > > >
> > > > Yes, Makes sense. So, It will look something like this, if this looks
> > > good,
> > > > I'll make the required changes.
> > > >
> > > > The layout of API Reference on the Site:
> > > > *OFBiz API Reference*
> > > >
> > > > - *Trunk API Reference*
> > > > - *Release 17.12 API Reference*
> > > > - *Next Release API Reference*
> > > >
> > >
> >
>
Re: API Reference on OFBiz site
Posted by Devanshu Vyas <vy...@gmail.com>.
Looks good to me.👍
Thanks & Regards,
Devanshu Vyas.
On Thu, Jul 16, 2020 at 4:42 PM Pawan Verma <pa...@hotwaxsystems.com>
wrote:
> Changes are live now, please have a look at
> https://ofbiz.apache.org/developers.html#DevDocs
>
> If we are good here the ticket can be closed now.
> --
> Thanks & Regards
> Pawan Verma
> Technical Consultant
> *HotWax Systems*
> *Enterprise open source experts*
> http://www.hotwaxsystems.com
>
>
> On Thu, Jul 16, 2020 at 3:26 PM Jacques Le Roux <
> jacques.le.roux@les7arts.com> wrote:
>
> > +1
> >
> > Jacques
> >
> > Le 16/07/2020 à 11:43, Pawan Verma a écrit :
> > > Thanks, Jacques, All for the response.
> > >
> > > Yes, Makes sense. So, It will look something like this, if this looks
> > good,
> > > I'll make the required changes.
> > >
> > > The layout of API Reference on the Site:
> > > *OFBiz API Reference*
> > >
> > > - *Trunk API Reference*
> > > - *Release 17.12 API Reference*
> > > - *Next Release API Reference*
> > >
> >
>
Re: API Reference on OFBiz site
Posted by Pawan Verma <pa...@hotwaxsystems.com>.
Changes are live now, please have a look at
https://ofbiz.apache.org/developers.html#DevDocs
If we are good here the ticket can be closed now.
--
Thanks & Regards
Pawan Verma
Technical Consultant
*HotWax Systems*
*Enterprise open source experts*
http://www.hotwaxsystems.com
On Thu, Jul 16, 2020 at 3:26 PM Jacques Le Roux <
jacques.le.roux@les7arts.com> wrote:
> +1
>
> Jacques
>
> Le 16/07/2020 à 11:43, Pawan Verma a écrit :
> > Thanks, Jacques, All for the response.
> >
> > Yes, Makes sense. So, It will look something like this, if this looks
> good,
> > I'll make the required changes.
> >
> > The layout of API Reference on the Site:
> > *OFBiz API Reference*
> >
> > - *Trunk API Reference*
> > - *Release 17.12 API Reference*
> > - *Next Release API Reference*
> >
>
Re: API Reference on OFBiz site
Posted by Jacques Le Roux <ja...@les7arts.com>.
+1
Jacques
Le 16/07/2020 à 11:43, Pawan Verma a écrit :
> Thanks, Jacques, All for the response.
>
> Yes, Makes sense. So, It will look something like this, if this looks good,
> I'll make the required changes.
>
> The layout of API Reference on the Site:
> *OFBiz API Reference*
>
> - *Trunk API Reference*
> - *Release 17.12 API Reference*
> - *Next Release API Reference*
>
Re: API Reference on OFBiz site
Posted by Pawan Verma <pa...@hotwaxsystems.com>.
Thanks, Jacques, All for the response.
Yes, Makes sense. So, It will look something like this, if this looks good,
I'll make the required changes.
The layout of API Reference on the Site:
*OFBiz API Reference*
- *Trunk API Reference*
- *Release 17.12 API Reference*
- *Next Release API Reference*
--
Thanks & Regards
Pawan Verma
Technical Consultant
*HotWax Systems*
*Enterprise open source experts*
http://www.hotwaxsystems.com
On Thu, Jul 16, 2020 at 1:46 PM Jacques Le Roux <
jacques.le.roux@les7arts.com> wrote:
> Hi Pawan,
>
> Indeed, next is for now more an internal concept.
>
> But, like it's now clear for stable - thanks to the demo, we could explain
> this concept to users. It's simple: the next branch to be released. This
> would prevent to have to modify (and often forget) the real reference, ie
> R18 for now.
>
> Jacques
>
> Le 16/07/2020 à 09:49, Pawan Verma a écrit :
> > Hi Jacques,
> >
> > Yes, seems like a good idea to expose the next API too. But I am not
> fully
> > aware of the next API and curious about the label means Next API
> Reference,
> > wouldn't it be confusing for the user?
>
>
Re: API Reference on OFBiz site
Posted by Jacques Le Roux <ja...@les7arts.com>.
Hi Pawan,
Indeed, next is for now more an internal concept.
But, like it's now clear for stable - thanks to the demo, we could explain this concept to users. It's simple: the next branch to be released. This
would prevent to have to modify (and often forget) the real reference, ie R18 for now.
Jacques
Le 16/07/2020 à 09:49, Pawan Verma a écrit :
> Hi Jacques,
>
> Yes, seems like a good idea to expose the next API too. But I am not fully
> aware of the next API and curious about the label means Next API Reference,
> wouldn't it be confusing for the user?
Re: API Reference on OFBiz site
Posted by Pawan Verma <pa...@hotwaxsystems.com>.
Hi Jacques,
Yes, seems like a good idea to expose the next API too. But I am not fully
aware of the next API and curious about the label means Next API Reference,
wouldn't it be confusing for the user?
--
Thanks & Regards
Pawan Verma
Technical Consultant
*HotWax Systems*
*Enterprise open source experts*
http://www.hotwaxsystems.com
On Wed, Jul 15, 2020 at 2:38 PM Jacques Le Roux <
jacques.le.roux@les7arts.com> wrote:
> After thought: why not expose the next API too?
>
> Jacques
>
> Le 15/07/2020 à 10:19, Olivier Heintz a écrit :
> > +1 to the 2nd option
> >
> > Le 15/07/2020 à 09:58, Devanshu Vyas a écrit :
> >> +1 to the 2nd option.
> >>
> >> Thanks & Regards,
> >> Devanshu Vyas.
> >>
> >>
> >> On Wed, Jul 15, 2020 at 10:56 AM Pritam Kute <
> pritam.kute@hotwaxsystems.com>
> >> wrote:
> >>
> >>> I am also inclined to 2nd option.
> >>>
> >>> Thanks, Pawan for pointing this.
> >>>
> >>> Kind Regards,
> >>> --
> >>> Pritam Kute
> >>>
> >>>
> >>> On Wed, Jul 15, 2020 at 1:24 AM Jacques Le Roux <
> >>> jacques.le.roux@les7arts.com> wrote:
> >>>
> >>>> Thanks Pawan,
> >>>>
> >>>> The 2nd options looks like a good idea to me.
> >>>>
> >>>> Jacques
> >>>>
> >>>> Le 14/07/2020 à 15:38, Pawan Verma a écrit :
> >>>>> Hello Devs,
> >>>>>
> >>>>> Since Oliver has refactored documentation with new directories
> >>> structure
> >>>>> with the trunk, next and stable API Reference link becomes stale.
> >>>>>
> >>>>> Question: What should be the API Reference link on the site?
> >>>>>
> >>>>> Possible Solutions:
> >>>>> #1: We can use the link for stable APIs for Site as suggested by
> >>> Jacques
> >>>> on
> >>>>> Jira OFBIZ-11888.
> >>>>>
> >>>>> #2: We can show the link for both trunk and stable release like Build
> >>> and
> >>>>> Run section.
> >>>>> Example:
> >>>>> * OFBiz API Reference*
> >>>>>
> >>>>> - *Trunk API Reference*
> >>>>> - *Release 17.12 API Reference*
> >>>>>
> >>>>> Please share your thoughts on this. TIA!
> >>>>>
>
Re: API Reference on OFBiz site
Posted by Jacques Le Roux <ja...@les7arts.com>.
After thought: why not expose the next API too?
Jacques
Le 15/07/2020 à 10:19, Olivier Heintz a écrit :
> +1 to the 2nd option
>
> Le 15/07/2020 à 09:58, Devanshu Vyas a écrit :
>> +1 to the 2nd option.
>>
>> Thanks & Regards,
>> Devanshu Vyas.
>>
>>
>> On Wed, Jul 15, 2020 at 10:56 AM Pritam Kute <pr...@hotwaxsystems.com>
>> wrote:
>>
>>> I am also inclined to 2nd option.
>>>
>>> Thanks, Pawan for pointing this.
>>>
>>> Kind Regards,
>>> --
>>> Pritam Kute
>>>
>>>
>>> On Wed, Jul 15, 2020 at 1:24 AM Jacques Le Roux <
>>> jacques.le.roux@les7arts.com> wrote:
>>>
>>>> Thanks Pawan,
>>>>
>>>> The 2nd options looks like a good idea to me.
>>>>
>>>> Jacques
>>>>
>>>> Le 14/07/2020 à 15:38, Pawan Verma a écrit :
>>>>> Hello Devs,
>>>>>
>>>>> Since Oliver has refactored documentation with new directories
>>> structure
>>>>> with the trunk, next and stable API Reference link becomes stale.
>>>>>
>>>>> Question: What should be the API Reference link on the site?
>>>>>
>>>>> Possible Solutions:
>>>>> #1: We can use the link for stable APIs for Site as suggested by
>>> Jacques
>>>> on
>>>>> Jira OFBIZ-11888.
>>>>>
>>>>> #2: We can show the link for both trunk and stable release like Build
>>> and
>>>>> Run section.
>>>>> Example:
>>>>> * OFBiz API Reference*
>>>>>
>>>>> - *Trunk API Reference*
>>>>> - *Release 17.12 API Reference*
>>>>>
>>>>> Please share your thoughts on this. TIA!
>>>>>
Re: API Reference on OFBiz site
Posted by Olivier Heintz <ho...@apache.org>.
+1 to the 2nd option
Le 15/07/2020 à 09:58, Devanshu Vyas a écrit :
> +1 to the 2nd option.
>
> Thanks & Regards,
> Devanshu Vyas.
>
>
> On Wed, Jul 15, 2020 at 10:56 AM Pritam Kute <pr...@hotwaxsystems.com>
> wrote:
>
>> I am also inclined to 2nd option.
>>
>> Thanks, Pawan for pointing this.
>>
>> Kind Regards,
>> --
>> Pritam Kute
>>
>>
>> On Wed, Jul 15, 2020 at 1:24 AM Jacques Le Roux <
>> jacques.le.roux@les7arts.com> wrote:
>>
>>> Thanks Pawan,
>>>
>>> The 2nd options looks like a good idea to me.
>>>
>>> Jacques
>>>
>>> Le 14/07/2020 à 15:38, Pawan Verma a écrit :
>>>> Hello Devs,
>>>>
>>>> Since Oliver has refactored documentation with new directories
>> structure
>>>> with the trunk, next and stable API Reference link becomes stale.
>>>>
>>>> Question: What should be the API Reference link on the site?
>>>>
>>>> Possible Solutions:
>>>> #1: We can use the link for stable APIs for Site as suggested by
>> Jacques
>>> on
>>>> Jira OFBIZ-11888.
>>>>
>>>> #2: We can show the link for both trunk and stable release like Build
>> and
>>>> Run section.
>>>> Example:
>>>> * OFBiz API Reference*
>>>>
>>>> - *Trunk API Reference*
>>>> - *Release 17.12 API Reference*
>>>>
>>>> Please share your thoughts on this. TIA!
>>>>
>>>
>>
>
Re: API Reference on OFBiz site
Posted by Devanshu Vyas <vy...@gmail.com>.
+1 to the 2nd option.
Thanks & Regards,
Devanshu Vyas.
On Wed, Jul 15, 2020 at 10:56 AM Pritam Kute <pr...@hotwaxsystems.com>
wrote:
> I am also inclined to 2nd option.
>
> Thanks, Pawan for pointing this.
>
> Kind Regards,
> --
> Pritam Kute
>
>
> On Wed, Jul 15, 2020 at 1:24 AM Jacques Le Roux <
> jacques.le.roux@les7arts.com> wrote:
>
> > Thanks Pawan,
> >
> > The 2nd options looks like a good idea to me.
> >
> > Jacques
> >
> > Le 14/07/2020 à 15:38, Pawan Verma a écrit :
> > > Hello Devs,
> > >
> > > Since Oliver has refactored documentation with new directories
> structure
> > > with the trunk, next and stable API Reference link becomes stale.
> > >
> > > Question: What should be the API Reference link on the site?
> > >
> > > Possible Solutions:
> > > #1: We can use the link for stable APIs for Site as suggested by
> Jacques
> > on
> > > Jira OFBIZ-11888.
> > >
> > > #2: We can show the link for both trunk and stable release like Build
> and
> > > Run section.
> > > Example:
> > > * OFBiz API Reference*
> > >
> > > - *Trunk API Reference*
> > > - *Release 17.12 API Reference*
> > >
> > > Please share your thoughts on this. TIA!
> > >
> >
>
Re: API Reference on OFBiz site
Posted by Pritam Kute <pr...@hotwaxsystems.com>.
I am also inclined to 2nd option.
Thanks, Pawan for pointing this.
Kind Regards,
--
Pritam Kute
On Wed, Jul 15, 2020 at 1:24 AM Jacques Le Roux <
jacques.le.roux@les7arts.com> wrote:
> Thanks Pawan,
>
> The 2nd options looks like a good idea to me.
>
> Jacques
>
> Le 14/07/2020 à 15:38, Pawan Verma a écrit :
> > Hello Devs,
> >
> > Since Oliver has refactored documentation with new directories structure
> > with the trunk, next and stable API Reference link becomes stale.
> >
> > Question: What should be the API Reference link on the site?
> >
> > Possible Solutions:
> > #1: We can use the link for stable APIs for Site as suggested by Jacques
> on
> > Jira OFBIZ-11888.
> >
> > #2: We can show the link for both trunk and stable release like Build and
> > Run section.
> > Example:
> > * OFBiz API Reference*
> >
> > - *Trunk API Reference*
> > - *Release 17.12 API Reference*
> >
> > Please share your thoughts on this. TIA!
> >
>
Re: API Reference on OFBiz site
Posted by Jacques Le Roux <ja...@les7arts.com>.
Thanks Pawan,
The 2nd options looks like a good idea to me.
Jacques
Le 14/07/2020 à 15:38, Pawan Verma a écrit :
> Hello Devs,
>
> Since Oliver has refactored documentation with new directories structure
> with the trunk, next and stable API Reference link becomes stale.
>
> Question: What should be the API Reference link on the site?
>
> Possible Solutions:
> #1: We can use the link for stable APIs for Site as suggested by Jacques on
> Jira OFBIZ-11888.
>
> #2: We can show the link for both trunk and stable release like Build and
> Run section.
> Example:
> * OFBiz API Reference*
>
> - *Trunk API Reference*
> - *Release 17.12 API Reference*
>
> Please share your thoughts on this. TIA!
>