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 "Development Resources/Data Driven Project Website"

 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
Projects can opt to use an automatically-generated project landing page. This page uses data from various sources, including [[Development Resources/HOWTO/Project Meta-Data|Project Metadata]], Bugzilla, and IPZilla.
+
#REDIRECT [[Project Management Infrastructure/Project Metadata]]
 
+
[[Image:Projectsummary2.png]]
+
 
+
The '''title''' comes from the ''projectname'' metadata entry; if this entry is not specified, the value is obtained from the projects database that I maintain (so you can override the value, or remain at my mercy).
+
 
+
The '''description''' comes from a file provided by the project and referenced by the ''descriptionurl'' metadata entry. The value in the metadata should point to a file containing the HTML to display as the project's description. A paragraph or two is recommended (perhaps this can be taken from the project's proposal). As a general rule, you should avoid messing around withthe presentation (i.e. style), or adding too many links in this content especially to content that is otherwise linked by the page (e.g. downloads). Since a lot of projects do a rather poor job of specifying this value (many just stuff a link to their project home page), we do a few relatively clever things to try and scavenge a useful value. By simply providing a link to a reasonable file, this part of the page can look pretty sharp. The '''logo''' comes from the ''logourl'' metadata entry. It's only displayed if it is actually provided.
+
 
+
Commits activity is generated from [http://dash.eclipse.org Dash] data. It is only displayed if information is available. Dash uses the ''sourcerepository'' entries provided in the portal to do its work.
+
 
+
[[Image:Portal-sourcerepositories.png]]
+
 
+
Company Activity provides a different view of the same Dash data and depends on the same metadata entries. This pie chart shows the relative contributions from the various companies that contribute development resources to the project. Only those companies that have contributed a least one commit in the last three months are displayed.
+
 
+
The '''Source Repositories''' section lists the repositories specified in the ''sourcerepositories'' metadata entry. This section provides handy links to the actual repositories.
+
 
+
The '''Releases''' section is built from the ''release'' metadata entries. Only the information that's provided is displayed. There are sub-entries that capture things like "new and noteworthy" documents, IP Logs, plans, etc.
+
 
+
The '''Reviews''' section is also built from project metadata, but it is metadata that is maintained on the project's behalf by the EMO.
+
 
+
The left side of the page provides other useful project information harvested from other metadata entries (like the ''wikiurl'', ''updatesiteurl'', and ''downloadsurl''), and some handy navigation through the project hierarchy.
+
 
+
The right side displays information about the people involved in the project. Bold entries indicate project-specific activity within the last three months. Similarly, the list of supporting organizations contains only those projects who have had at least one committer make at least one commit in the last three months.
+
 
+
If you want to use this page as your project home page, change the contents of your project's ''index.php'' file to:
+
 
+
<?php
+
header("Location: http://www.eclipse.org/projects/project.php?id=your.project.id");
+
?>
+
 
+
(with an appropriate substitution of ''your.project.id'', of course).
+
 
+
Note that the automatically-generated pages will continue to grow, change, and be updated.
+

Latest revision as of 12:41, 15 March 2013

Back to the top