Difference between revisions of "General Meeting/SPDX Web Site Cleanup"

Item

Description

Source

Assigned To

Status

 1

 I noticed that the link on the home page for spdx-tech lower right under roles and responsibilities goes to a basically empty page (http://spdx.org/content/technical-0) .  I’m not sure if the page just needs to be filled in or if it should link to http://spdx.org/wiki/spdx/spec-development

 Gary

 2

 Raise up SPDX License List on the menu hierarchy

 Jilayne

 3

 SPDX Tech Page Comments
 - Add Bug Tracking page. Seperate for spec and tools. Have anonymous qeuries.
 - Need a page added for the current spec so we can park the use case  indfo. Maybe move to the spec area?

 Tech team Review

 4

U nder http://spdx.org/about-spdx
It says:
This site is the home for everything SPDX and is the workspace for SPDX Groups.
I think this should be rephrased to:
This site is the home for everything SPDX and is the workspace for the SPDX sub-groups (Legal, Technical and Business).
On that same page, sometimes we call it "SPDX Standard" and then "SPDX Specification". Are these used interchangeably? It's unclear.

 Ibrahim

 5

 I think this paragraph can use some rephrasing:
Original:
The SPDX specification is developed by the SPDX workgroup, which is hosted by the Linux Foundation. The grass-roots effort includes representatives from more than 20 organizations—software, systems and tool vendors, foundations  and systems integrators—all committed to creating a standard for software package data exchange formats.
Suggested:
The SPDX project is hosted at the Linux Foundation that provides a neutral environment for collaboration. The SPDX standard is developed by the participants of the project which include representatives from more than 20 organizations—software, systems and tool vendors, open source foundations and systems integrators. The SPDX participants are committed to creating a standard for software package data exchange formats.

 Ibrahim

 6

 Term-wise:
SPDX is a Working Group of the Linux Foundation. It's Technical, Business and Legal teams are considered sub-groups. This needs to be updated through out the pages. For instance, the blue box "PARTICIPATE - Join a Working Group" need to be changed to something like "PARTICIPATE - Join a Task Force" or "PARTICIPATE - Join a Working Sub-Group" or something of that sort. (Update) I later read also that these are called teams. This needs to be updated to be consistent. 

 Ibrahim

 7

 Under http://spdx.org/about-spdx/background
You jump to this page from: http://spdx.org/about-spdx

 Ibrahim

 8

 The background is repetitive from the first landing page and thats fine. I think there is no need to force new page jump again for the user to see new content.
I suggest moving the text from History and "Vision, Strategy and Execution" to http://spdx.org/about-spdx/background. Currently they have their own URLs. 

 Ibrahim

 9

 Under http://spdx.org/content/tutorials

Aesthetics aside, is it possible to provide a 1-2 lines description of what the paper, webinar and spec are?
 For an example, visit http://www.linuxfoundation.org/publications/workgroup and scroll towards the end where we feature the SPDX paper.

The SPDX video is hosted on BlackDuck site. I think this should live under spdx.org. You can get a youtube or vimeo account for spdx and host videos there and embed them on the spdx.org site. 

If I click on "Read the Spec" blue box I get transfered to http://www.linuxfoundation.org/publications/workgroup. This is not a tutorial.
On that new URL, there is also a mention of License List. For new reader, this is first mention. I think you may need some basic description.
It feel that the site keeps throwing users from one page to another.

 Ibrahim

 10

 UNDER http://spdx.org/content/how-participate


How to participate?


I think this pages requires an overhall in terms of reorganizing the material,


1) I could not find anything at all about the project governance. How decisions are made? by whom? who drives the project? how roadmap items get decided? who does the work? is participation tied to providing resources? how to become a chair in a sub-workgroup? how to be a chair of SPDX? etc etc.


2) Participation seems to be treated differently than Contributing. This is related to item 1) above - governance.


3) It feels as if this is treated as an open source project. I may be wrong. However, in all of the similar efforts I participated in for the past 12 years (at OSDL and other efforts at the LF), a standard similar to SPDX has usually two branches: the specs itself driven by committed companies who want to move the standard and get it adopted and use it, and the reference implementation which is open to anyone and everyone to participate in. Is this something you considered?


4) Also under this page, it mentions the 3 sub-groups with links to the page of each of them. The pages for all 3 sub-groups are formatted in a different way with different set of info presented. (Update) Later on I discovered new pages that discuss what the teams do (totally random). http://spdx.org/content/business and http://spdx.org/content/legal and http://spdx.org/content/technical.

 Ibrahim

 11

 Lots of empty pages. As examples, Roles and Responsibilities" page is empty: http://spdx.org/content/roles-responsibilities, Archive Specifications" page ie empty http://spdx.org/content/archive-specifications
"White Papers" page is empty http://spdx.org/content/white-papers
"Working Group Roster" page is empty http://www.spdx.org/content/working-group-roster
"SPDX Users" page is empty http://www.spdx.org/content/spdx-users

 Ibrahim

 12

 Ibrahim