StaticWebPages - coin-or-foundation/tlc GitHub Wiki

Procedure for Maintaining Static Web Pages

Background

In the past project managers have expressed the desire that their project's home page should be some sort of static home page, not the Trac page. Currently, this is done by creating a subdirectory in the CoinWeb repository for each project, but with the number of projects growing quickly, this has become unwieldy. It is therefore desired to the static pages associated with each project to within the project's SVN repository. This will make maintenance much easier for the project manager and will also make maintenance of the CoinWeb repository easier.

New Procedure

The following new procedure for the maintenance of project static Web pages has been adopted.

  • http://www.coin-or.org/PROJ will go to the static pages associated with PROJ, while http://projects.coin-or.org/PROJ will go to the Trac page of PROJ.
  • The static pages of project PROJ will be kept in svn in a directory named html/ in the root of the project's repository (so it can be checked out with svn co https://projects.coin-or.org/svn/PROJ/html PROJ-html). Anytime anything is committed into this directory, a post-commit script will automatically push the changes out to the web site. This will make it easy for PMs to maintain their own static pages. The existing static pages from the CoinWeb SVN repository will be copied to the project's html/ subdirectory using a script that preserves history.
  • COIN-OR will provide a default index.html for each project that doesn't have static pages that will redirect to the project's Trac page. Thus, for each project that does not have a static index.html, the Trac page will automatically be displayed.
  • In the list of the projects, the link provided for each project will be to http://www.coin-or.org/PROJ.