1. Messages
  2. Creating a general FAQ for OpenChain

Re: Creating a general FAQ for OpenChain

Shane Martin Coughlan <shane@...>
 

Hi Mark

Great points. Adjusted FAQ with some polishing for non-native speakers below for review if time permits on the call today. 

I also wanted to note we may want to adjust the main website page. As you correctly pointed out in your mail below, OpenChain has yet to venture into best practices, but “What is OpenChain” on our landing page mentions companies addressing many friction points and re-creating processes before it talks about compliance. This may lead to some confusion about our emphasis:
Perhaps we could adjust to “OpenChain was created to address FOSS-related friction points in the software supply chain. The focus of OpenChain today is helping to prevent companies redundantly recreating compliance work that upstream companies have already done or should have done."

== Updated FAQ for Discussion ==

What is OpenChain?

The OpenChain Project helps to identify and share the core components of a high quality Free and Open Source Software (FOSS) compliance program. OpenChain conformance builds trust in the supply chain by describing how Open Source license requirements have been met in distributed software.

How does OpenChain work?

The OpenChain Project has three working groups open for anyone to contribute to:
* Specification Working Group - identifies and publishes  a set of core requirements a quality FOSS compliance program should satisfy
* Curriculum Working Group - provides training material to help companies meeting the Specification education requirements.
* Conformance Working Group - helps companies check that they are adhering to the Specification requirements

There are also three governing committees with paid membership. 
* Governing Board - Manage policies or rules and procedures for the Project, fund raising, budgeting and so forth. 
* Steering Committee - Development, management and updating of the OpenChain Compliance Specification
* Outreach Committee - designing, developing and executing efforts to build an OpenChain compliance ecosystem throughout relevant supply chains in collaboration with the Governing Board

The Specification is the heart of OpenChain. It describes the processes required to achieve effective management of FOSS in the supply chain. OpenChain Curriculum provides training material to help companies meeting the Specification requirements. OpenChain Conformance helps companies check that they are adhering to the Specification requirements.

Where can I learn more about each aspect of OpenChain?

There are Frequently Asked Question (FAQ) pages for Specification, Curriculum and Conformance: 
 * https://wiki.linuxfoundation.org/openchain/specification-questions-and-answers
 * https://wiki.linuxfoundation.org/openchain/curriculum-questions-and-answers
 * https://wiki.linuxfoundation.org/openchain/conformance-questions-and-answers

Regards

Shane

On 2016 Oct 31, at 14:53, Gisi, Mark <Mark.Gisi@...> wrote:

What is OpenChain?

The OpenChain Project is focused on identifying common best practices that should be 
applied across a supply chain for efficient and effective compliance with Open Source 
licenses.

OpenChain has yet to venture to far into providing best practices. And although it will in due time I believe it is a secondary objective. I attempted to describe the current objective as follows:

Q: What is OpenChain?

A: The OpenChain Project identifies and publishes a set of core requirements a quality FOSS compliance program should satisfy. Program requirement conformance fosters trust among software supply chain participates that the open source license compliance obligations have been met for the software that one distributes and/or receives.

This is more technical and could benefit from further wordsmithing. It combines the first two questions into one (What is + Mission). It was not my intent to combined them into one question, but I felt a need to mention the mission in order to answer the question "What is OpenChain"

How does OpenChain work?

There are three parts to the OpenChain Project:
* OpenChain Specification
* OpenChain Curriculum
* OpenChain Conformance

This is another important question to address. I suggest providing a little more detail as follows:

Q: How is the OpenChain Project Organized?

A: The OpenChain Project consists of the following three working groups which are open for anyone to contribute to:
* Specification Working Group - identifies and publishes  a set of core requirements a quality FOSS compliance program should satisfy
* Curriculum Working Group - provides training material to help companies meeting the Specification education requirements.
* Conformance Working Group - helps companies check that they are adhering to the Specification requirements

And three governing committees that are determined by paid membership. 
* Governing Board - Manage policies or rules and procedures for the Project, fund raising, budgeting and so forth. 
* Steering Committee - Development, management and updating of the OpenChain Compliance Specification
* Outreach Committee - designing, developing and executing efforts to build an OpenChain compliance ecosystem throughout relevant supply chains in collaboration with the Governing Board

- Mark


-----Original Message-----
From: openchain-bounces@... [mailto:openchain-bounces@...] On Behalf Of Shane Martin Coughlan
Sent: Sunday, October 30, 2016 7:59 PM
To: openchain@...
Subject: Re: [OpenChain] Creating a general FAQ for OpenChain

Dear all

I wanted to send a reminder on the General FAQ as outlined below. Mike from Linux Foundation is ready to activate this FAQ on our site if there is consensus that it fits requirements. Comments and suggestions welcome.

Regards

Shane

On 2016 Oct 21, at 16:26, Shane Martin Coughlan <shane@...> wrote:

Dear all

We currently have a great website with a link to a FAQ. However, our current FAQ is Specification-centric. Check it out here:
https://www.openchainproject.org/faq
Mark, Miriam and the rest of the team discussed the utility of creating a more general FAQ for our landing page that then leads to specific FAQs for Specification, Curriculum and Conformance. I have taken the liberty of creating a draft for how this general FAQ may look as well as populating the Specification and Curriculum FAQs on the wiki:

What is OpenChain?

The OpenChain Project is focused on identifying common best practices that should be applied across a supply chain for efficient and effective compliance with Open Source licenses.

What is OpenChain’s mission?

The OpenChain Project's mission is to establish requirements to achieve effective management of Free and Open Source Software (FOSS) for software supply chain participants.

How does OpenChain work?

There are three parts to the OpenChain Project:
* OpenChain Specification
* OpenChain Curriculum
* OpenChain Conformance

The Specification is the heart of OpenChain. It describes the processes required to achieve effective management of Free and Open Source Software in the supply chain. OpenChain Curriculum provides training material to help companies meeting the Specification requirements. OpenChain Conformance helps companies check that they are adhering to the Specification requirements.

Where can I learn more about each aspect of OpenChain?

There are Frequently Asked Question (FAQ) pages for Specification, Curriculum and Conformance: 
* https://wiki.linuxfoundation.org/openchain/specification-questions-and-answers
* https://wiki.linuxfoundation.org/openchain/curriculum-questions-and-answers
* https://wiki.linuxfoundation.org/openchain/conformance-questions-and-answers

Input, adjustments and improvements welcome!

Regards

Shane
_______________________________________________
OpenChain mailing list
OpenChain@...
https://lists.linuxfoundation.org/mailman/listinfo/openchain

_______________________________________________
OpenChain mailing list
OpenChain@...
https://lists.linuxfoundation.org/mailman/listinfo/openchain
Join main@lists.openchainproject.org to automatically receive all group messages.