Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Project Management Infrastructure/Project Metadata"

(Why is project status information important?)
(Categories)
Line 147: Line 147:
 
</td></tr>
 
</td></tr>
 
</table>
 
</table>
 +
 +
====Inheritence====
 +
Currently sub-projects/components can inherit from their parent project by setting the "Inherit" key in the meta-data editor.  This special key will cause web pages and other places where the meta-data is used, to override all values other than the projectname key.  This is typically used for very small projects or components which do not need to maintain much information.
  
 
=== When is project status information considered out-of-date?===
 
=== When is project status information considered out-of-date?===

Revision as of 17:03, 8 July 2009

What is project meta-data?

  1. Relatively static structural information such as the names of the project's mailing lists and newsgroups, the bugzilla products and CVS repository, etc.
  2. Historical information such as previous release downloads, release review slides and IP logs, etc.
  3. Status and future looking information such as the project and milestone plans, the features scheduled for the current release, release dates, etc.

Who maintains it?

Eclipse committers and project leads are responsible for maintaining their project's meta-data. This information is an important part of being an Eclipse project.

How do I maintain my meta-data?

Use the portal. Look in Eclipse Projects > [view] > [maintain] Project meta-data.

What Meta-Data Does What

Missing information on various eclipse.org website pages are caused either (a) by the project not providing the meta-data, or (b) by the project not having an instance of that resource.

/projects/ page

WhatData Storage w/ Link to How to Update
Project Name projectname in the project meta data. Use the portal.
Info PageStandard format page for all projects
Phase Foundation internal database. Email emo@
Home Page projecturl in the project meta data. Use the portal.
Newsgroup newsgroup.name in the project meta data. Use the portal.
Mailing List mailinglist.name in the project meta data. Use the portal.
Wiki wikiurl in the project meta data. Use the portal.
IP Log iplogurl in the project meta data. Use the portal.

Standard project information page

E.g., Project Dash's standard information page

For those more visual people, there's also an annotated screenshot of a standard information page.

Name Foundation internal database. Email emo@
Download downloadsurl in the project meta data. Use the portal.
Description descriptionurl in the project meta data. Use the portal.

Should be an html paragraph or two (recommended). If the url points to an eclipse.org website page, we attempt to extract the

midcolumn contents as the paragraph.
Logo logourl in the project meta data. Use the portal.
Commits Activity sourcerepository in the project meta data. Use the portal.
Newsgroups newsgroup.* in the project meta data. Use the portal.
Mailing Lists mailinglist.* in the project meta data. Use the portal.
Source Repository sourcerepository.* in the project meta data. Use the portal.
Committers Foundation internal database. Email emo@.

Activity is taken from the commits explorer driven by sourcerepository in the project meta data. Use the portal. Active is any commit activity in the last three months, participating is any in the last nine months. Company logos are shows for member companies

of active committers.
Leaders Foundation internal database. Email emo@
Update site updatesiteurl in the project meta data. Use the portal.
Releases release.* in the project meta data. Use the portal. Valid release status includes: scheduled, completed, tentative.
Bugs bugzilla in the project meta data. Use the portal.
Website Foundation internal database. Email emo@
Wiki wikiurl in the project meta data. Use the portal.
Documentation documentationurl in the project meta data. Use the portal.
Articles articleurl in the project meta data. Use the portal.
Project Plan projectplanurl in the project meta data. Use the portal.
Mentors Set by Architecture Council members using the portal.

Project Plan Page

Project Plan projectplanurl in the project meta data. Use the portal. Also see the documentation.

Mailing Lists Page

The eclipse.org list of mailing lists.

Mailing List mailinglist.* in the project meta data. Use the portal.
Topics Foundation internal database. Email emo@

Newsgroups Page

The eclipse.org list of newsgroups.

Newsgroup newsgroup.* in the project meta data. Use the portal.
Topics Foundation internal database. Email emo@

Timeline

The eclipse.org timeline page. <table border="1" <tr> <td>Releases</td><td> release.* in the project meta data. Use the portal. Valid release status includes: scheduled, completed, tentative.</td></tr> </table>

Categories

Category categories in the project meta data. Use the portal.
Description paragraphurl in the project meta data. Use the portal.
Homepage projecturl in the project meta data. Use the portal.
Newsgroups newsgroup.* in the project meta data. Use the portal.
Mailing Lists mailinglist.* in the project meta data. Use the portal.
Wiki wikiurl in the project meta data. Use the portal.
Docs documentationurl in the project meta data. Use the portal.
Download downloadsurl in the project meta data. Use the portal.

Inheritence

Currently sub-projects/components can inherit from their parent project by setting the "Inherit" key in the meta-data editor. This special key will cause web pages and other places where the meta-data is used, to override all values other than the projectname key. This is typically used for very small projects or components which do not need to maintain much information.

When is project status information considered out-of-date?

Different kinds of information go out of date at different rates and times, but here's an easy checklist:

  • All structural status information is out-of-date if it does not match the infrastructure. For example, if the project has added a new project-announce@ mailing list, but the project status files do not list that mailing list, then they are out of date.
  • Status summaries must be updated at least once a quarter. It's better to update them once a month.
  • Historical information (downloads, release information, and so on) and status summaries need updating with each release (obviously).

Why is project status information important?

Eclipse projects belong to a larger community - Eclipse - which is comprised of not only the committers and developers on the project, but also the developers on other projects, plug-in developers outside the Eclipse projects, and the entire ecosystem surrounding Eclipse. In order to keep all these people up-to-date on the direction and status of the Eclipse projects, each project needs to provide timely and accurate descriptive and status information. (See "2.4 Eclipse Ecosystem" in the Eclipse Development Process.)

The project status information drives a number of the eclipse.org web pages including the categories on the home page, the dashboard, the timeline, lists of projects, lists of mailing lists and newsgroups, status pages, and more.

Using the Infrastructure

RAll projects are required to use the standard left menu on the project home page. See the detailed, but easy, instructions for how to make that left menu appear.

Back to the top