THE SPDX WIKI IS NO LONGER ACTIVE. ALL CONTENT HAS BEEN MOVED TO https://github.com/spdx
General Meeting/SPDX Web Site Cleanup
The following table lists the curret issues/improvments that need to be made to the SPDX website following our conversion thiis past month from the old site to the new one.
The list was intiially populated by Jack Manbeck but feel free to add to or modify the contents. Note: I found it a little challenging to add a table to the wiki and to be able to format it. I ended up restorting to HTML. This may make it challangeing for some to add items. If thats the case, please feel free to post to the list and I can make the appopriate changes or add a line after the table stating who you are and what your feedback is.
The Assigned To and Status fields will be taken care of by the web revamp team.
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
|
Tech team Review |
||
4 |
Under 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 |
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 |
Ibrahim |
||
12 |
I am not sure if I covered all pages.. In any case, generally speaking, the site needs updates on its: - Structure / Brows-ability / Usability - Updating text / content - Updating menu items - Consistency in terminology - Removing dead pages and consolidating existing pages - Formatting text on pages - Page divisions and linkages between pages - Governance information is either absent or I could not find it - Roadmap information is either absent or I could not find it ( Priorities page is empty http://spdx.org/content/current-priorities-work-progress-2) |
Ibrahim |
||
13 | The Collateral material here need to be cleaned up and a final version published (incl new pdf file): http://spdx.org/documentation/beta-collateral What's "Email blurb for recruiting beta sites" at the top of that page? Another collateral page: http://spdx.org/content/spdx-launch-collateral - maybe merge with http://spdx.org/documentation/beta-collateral? |
Ibrahim | ||
14 | Are the contacts still valid? http://spdx.org/about/spdx/contact | Ibrahim | ||
15 | Add self subsubscribing pages for membership | Jack | ||
16 | Workgroups are posting meeting info on their main page and under the menu item for meeting calnedar and access. Propose to only put under the meeting calendar and access page. Its a little confusing in two places and often the text is not the same. | Jack | ||
17 | Add new mission and vision to the site | Jack | ||
18 | Add links to tools that support SPDX (perhaps on the tools page that is empty?) | Jack | ||
19 | The Roles and reponsibilities pages are empty. Should move that info from the sub team pages to here. | Jack | ||
20 | Add an overall meeting calendar for the year and dates for F2F meetings (can link out to wiki for agendas) | Jack/Steve | ||
21 | We should use generic SPDX email names instead of personal ones on the site for people (people move on, etc). | Business Team |
If you find it difficult to add a new line you can also comment here: