OFBiz.org site: easier navigation to Service Providers and End Users

[Jacopo Cappellato-4]

On Feb 20, 2014, at 10:20 AM, Jacopo Cappellato <[hidden email]> wrote:

> * I would like to review examples from other ASF projects doing the same; in this thread it was mentioned that several other projects are doing the same; I don't have time to research but if a volunteer could provide a list of projects and URLs of such documents I would be happy to review them

I have reviewed all the URL with examples of other ASF projects that you all sent me (thanks) and here is my preference:

1) the (new) page containing "service providers for OFBiz" will be hosted in the OFBiz website as a static html page (not in the Wiki, but we could leave the existing one there): this means that only committers will be able to edit it
2) the page will have a list of companies sorted in alphabetical order; only the name of the company (clickable, opens in a new browser tab the company's website) and a short description are allowed (we will define the maximum number of characters allowed); in the description the company can mention any information they like (committers, services provided, location, etc...)
3) in order to appear in the page, a company will have to send a mail to the OFBiz PMC, with the exact text to be included in the page
4) the PMC will review the proposal, will check if the company respects the ASF guidelines (trademarks etc...) and then will start a private vote; if the vote will pass (majority, not veto) then the company will be added to the page; if the vote will not pass, the PMC will prepare a response with detailed reasons for the rejection; of course the company could always fix them and resubmit a proposal
5) over time the PMC may review the list and vote for the removal of some companies (if they violates ASF guidelines, if they are no longer operating on OFBiz etc...)

I like the text in the Cayenne site (http://cayenne.apache.org/support.html ); following a similar template the OFBiz page could look like this:

==============================================
*Commercial Support And Consulting*

If your company also provides commercial services supporting Apache OFBiz, please drop a note to the OFBiz PMC (private at ofbiz dot apache dot org), we'll review your request and add a note to this page.

        • AAA. This is the description of the first company in the list.
        • AAB. This is the description of the second company in the list.
        • AAC. This is the description of the third company in the list.
==============================================

Jacopo

[Jacopo Cappellato-4]

A slightly better template for the page: now it is clearly stated that the list is sorted by alphabetical order and not relevance.

==============================================
*Commercial Support And Consulting*

These companies provide professional services around Apache OFBiz (sorted by alphabetical order)
If your company also provides commercial services supporting Apache OFBiz, please drop a note to the OFBiz PMC (private at ofbiz dot apache dot org), we'll review your request and add a note to this page.

        • AAA. This is the description of the first company in the list.
        • AAB. This is the description of the second company in the list.
        • AAC. This is the description of the third company in the list.
==============================================

Jacopo

[Jacques Le Roux]

Thanks Jacopo,

This seems indeed the better way to go for service providers. I agree also about the better template sent afterwards.

The reasons I agree:
* It would be now companies responsibility for supplied information
* The PMC can check and guarantee the quality and veracity of supplied information

If others agree, we need now to define the maximum number of characters allowed for companies description

Questions:
The "Apache OFBiz Service Providers" https://cwiki.apache.org/confluence/display/OFBIZ/Apache+OFBiz+Service+Providers will be removed, right?
Should we (PMC) not first review the current descriptions and reuse them if possible? On the other hand, deleting the page and beginning anew could
have some advantages. Mostly removing deprecated/not-maintained information and no have the responsibility of the companies description contents if we
have to adapt them (like having to change it because of length, content, etc.)

What about the "Apache OFBiz User List" page, notably the "Products and Projects based on Apache OFBiz" section?

Jacques

Le 24/02/2014 11:26, Jacopo Cappellato a écrit :

> On Feb 20, 2014, at 10:20 AM, Jacopo Cappellato <[hidden email]> wrote:
>
>> * I would like to review examples from other ASF projects doing the same; in this thread it was mentioned that several other projects are doing the same; I don't have time to research but if a volunteer could provide a list of projects and URLs of such documents I would be happy to review them
> I have reviewed all the URL with examples of other ASF projects that you all sent me (thanks) and here is my preference:
>
> 1) the (new) page containing "service providers for OFBiz" will be hosted in the OFBiz website as a static html page (not in the Wiki, but we could leave the existing one there): this means that only committers will be able to edit it
> 2) the page will have a list of companies sorted in alphabetical order; only the name of the company (clickable, opens in a new browser tab the company's website) and a short description are allowed (we will define the maximum number of characters allowed); in the description the company can mention any information they like (committers, services provided, location, etc...)
> 3) in order to appear in the page, a company will have to send a mail to the OFBiz PMC, with the exact text to be included in the page
> 4) the PMC will review the proposal, will check if the company respects the ASF guidelines (trademarks etc...) and then will start a private vote; if the vote will pass (majority, not veto) then the company will be added to the page; if the vote will not pass, the PMC will prepare a response with detailed reasons for the rejection; of course the company could always fix them and resubmit a proposal
> 5) over time the PMC may review the list and vote for the removal of some companies (if they violates ASF guidelines, if they are no longer operating on OFBiz etc...)
>
> I like the text in the Cayenne site (http://cayenne.apache.org/support.html ); following a similar template the OFBiz page could look like this:
>
> ==============================================
> *Commercial Support And Consulting*
>
> If your company also provides commercial services supporting Apache OFBiz, please drop a note to the OFBiz PMC (private at ofbiz dot apache dot org), we'll review your request and add a note to this page.
>
> • AAA. This is the description of the first company in the list.
> • AAB. This is the description of the second company in the list.
> • AAC. This is the description of the third company in the list.
> ==============================================
>
> Jacopo
>
>
>
>
>

[Jacopo Cappellato-4]

On Feb 24, 2014, at 12:12 PM, Jacques Le Roux <[hidden email]> wrote:

> Questions:
> The "Apache OFBiz Service Providers"https://cwiki.apache.org/confluence/display/OFBIZ/Apache+OFBiz+Service+Providers will be removed, right?

We can leave the page there; at least until we are happy with the new one (or even after).

> Should we (PMC) not first review the current descriptions and reuse them if possible?

I would prefer to start from scratch with the new process and wait for company proposals; in the meantime the current page will still be usable as is now.

Jacopo

[Jacopo Cappellato-4]

On Feb 24, 2014, at 12:12 PM, Jacques Le Roux <[hidden email]> wrote:

> What about the "Apache OFBiz User List" page, notably the "Products and Projects based on Apache OFBiz" section?

We could apply a similar pattern to the one we are discussing for the "service provider" list.

Jacopo

[Pierre Smits]

Hi Jacopo,

I like the outline of the proposed policy description and solution (the
page).

However, I do have to remark that companies can't be committers as per ASF
regulations. So leaving that and similar regarding PMC and Contributors out
of the company description would serve the 'unbiased' aspect of the project
better.

Furthermore, I would suggest to include the disclaimer (at least at the
top) regarding the aspect of not endorsing/favouring any company as per
your earlier posting in this thread.
Starting from a blank page would surely have a cleansing effect.

Lastly, thanks for taking the time to address this issue swiftly.

Regards,

Pierre Smits

*ORRTIZ.COM <http://www.orrtiz.com>*
Services & Solutions for Cloud-
Based Manufacturing, Professional
Services and Retail & Trade
http://www.orrtiz.com

[Jacopo Cappellato-4]

On Feb 24, 2014, at 1:29 PM, Pierre Smits <[hidden email]> wrote:

> So leaving that and similar regarding PMC and Contributors out
> of the company description would serve the 'unbiased' aspect of the project
> better.

I definitely agree that the fact that a company has employees that are committers in the project should not be relevant for the decision by the PMC to include it (or not) in the page; however I would leave it to the company to decide what content to include in its description (possibly mentioning a committer or not) based on company's strategy.

Jacopo

[Jacopo Cappellato-4]

On Feb 24, 2014, at 1:29 PM, Pierre Smits <[hidden email]> wrote:

> Furthermore, I would suggest to include the disclaimer (at least at the
> top) regarding the aspect of not endorsing/favouring any company

+1

Jacopo