umbrella projects? (Re: [Project-managers] Reminder: PLEASE check in your project descriptions)

Robin Lougee-Heimer robinlh at us.ibm.com
Tue Sep 18 13:14:10 EDT 2007


Great capability - thanks for putting this together. 

I see the "linked COIN-OR projects" -- I wish there was something simliar 
for umbrella projects people. 

Did I miss it in the design? 
What do you recommend? 
Can something be added?

Robin

----------------------------------------------------------------------------------
Robin Lougee-Heimer, PhD
Program Manager, COIN-OR
IBM TJ Watson Research Center
1101 Kitchawan Road, Yorktown Heights, NY 10598
ph: 914-945-3032   fax: 914-945-3434 
robinlh at us.ibm.com
http://www.coin-or.org





Ted Ralphs <tkralphs at lehigh.edu> 
Sent by: project-managers-bounces at list.coin-or.org
09/16/2007 04:02 PM

To
project-managers at list.coin-or.org
cc

Subject
[Project-managers] Reminder: PLEASE check in your project descriptions






Hi all,

As of now, most project managers still have not checked in their project 
XML pages. I would like to kindly ask if you could either take care of 
this small chore sometime in the next few days (it should take about 
5-10 minutes) or else let us know that you would prefer that we do it 
for you. While we would prefer that you do it, so that the page contains 
the information you want it to, we can help in case you just don't want 
to be bothered with it. However, we do need to know your preference and 
we'd like to have a page for every project up soon. Thanks for your help 
with this.

Cheers,

Ted

For your convenience, here is the text of the original e-mail:

=====================================================================

At long last, we have put in place a mechanism for automatic generation 
of project information pages. The idea is that each project manager will 
create and maintain an XML file containing basic project information. 
This XML file will be posted to the Web server and rendered by a parser 
that will display each project's info in a standard format. The 
procedure for getting your page up is very simple:

1. Edit the attached XML file, which has extensive comments to explain 
where to put each piece of information. XML is very similar to HTML, but 
with tags that can be customized. If you've ever looked at HTML, this 
should be very familiar. If not, please feel free to ask questions.

2. After you are done editing the file, add it to the conf/ directory of 
your project's repository and commit it. It is VERY IMPORTANT that you 
check it in with exactly the same name as it has now, i.e., you should 
execute exactly the following commands from the directory where the 
projDesc.xml file has been saved:

cp projDesc.xml ProjRoot/conf/
cd ProjRoot/conf/
svn add projDesc.xml
svn commit -m "Adding XML file to repository"

where ProjRoot is the root directory of your project. If you don't 
happen to have the conf directory checked out and you want to get just 
that directory without checking out the entire repository, just do

svn checkout https://projects.coin-or.org/svn/ProjName/conf

where ProjName is the name of your project. This will check out just the 
conf/ directory. After the projDesc.xml file is checked into your 
repository, an automatic script will copy it to the appropriate 
directory on the Web server and rename it so that it will be accessible 
from the address

http://www.coin-or.org/projects/ProjName.xml

where "ProjName" is again the actual name of your project. For example, 
see

https://projects.coin-or.org/SYMPHONY/browser/conf/projDesc.xml

for SYMPHONY's XML file. The comments have been stripped out so you can 
see what a minimal file looks like. To see how the file displays, you 
can go to

http://www.coin-or.org/projects/SYMPHONY.xml

We'd like to have XML files for all the projects up in the next couple 
of weeks. Please feel free to ask as many questions as you need to. If 
there are questions you think might be relevant to other PMs, please 
also post them to the list, so that everyone can benefit from the 
answers. We will also be adding these instruction to the CoinHelp wiki.

-- 
Dr. Ted Ralphs
Associate Professor
Industrial and Systems Engineering
Lehigh University
(610)758-4784
tkralphs at lehigh.edu
www.lehigh.edu/~tkr2
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type = "text/xsl" href = "
http://www.coin-or.org/projects/autoGen.xsl"?>
<projectData xmlns="coin-or.org" 
                 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                 xsi:schemaLocation="coin-or.org 
http://www.coin-or.org/projects/autoGen.xsd">

                 <!-- This file is a template that will you fill in in 
order to provide -->
                 <!-- specific information about your project. Once the 
template is     -->
                 <!-- filled in and checked into your projects repository 
in the conf/  -->
                 <!-- directory, it will be automatically parsed and 
displayed in a     -->
                 <!-- standard HTML format when users call up the file 
from the main    -->
                 <!-- COIN Web site. The file is extensively commented to 
help you      -->
                 <!-- understand where to fill in the various pieces of 
required        -->
                 <!-- information. The comments are enclosed in blocks 
like this one.   -->

                 <projectBasics>

                                 <!-- Fill in your project's name in this 
block.                -->
                                 <!-- For example, for SYMPHONY, you would 
put:                 -->
                                 <!--                      -->
                                 <!-- <projectName>  -->
                                 <!--    SYMPHONY                      -->
                                 <!-- </projectName>  -->
                                 <!--                      -->
                                 <!-- Fill in your text below (outside the 
comment block).      -->

                                 <projectName> </projectName>

                                 <!-- Fill in a brief description of your 
project here.         -->
                                 <!-- For example, for SYMPHONY, you might 
put:                 -->
                                 <!--                      -->
                                 <!-- <projectDescription>       -->
                                 <!--    SYMPHONY is an open-source 
generic MILP solver,        -->
                                 <!--    callable library, and extensible 
framework for         -->
                                 <!--    implementing customized solvers 
for mixed-integer      -->
                                 <!--    linear programs (MILPs). Blah, 
blah, blah.             -->
                                 <!-- </projectDescription>        -->
                                 <!--                      -->
                                 <!-- Fill in your text below (outside the 
comment block)       -->

                                 <projectDescription> 
</projectDescription>

                                 <!-- Fill in the project manager's name 
and (obfuscated)       -->
                                 <!-- e-mail address here (only one name 
allowed).              -->
                                 <!-- For example, for the SYMPHONY 
project, you would put      -->
                                 <!--                      -->
                                 <!--<projectManager>  -->
                                 <!--   Ted Ralphs, tkralphs at lehigh dot 
edu                  -->
                                 <!--</projectManager>   -->
                                 <!--                      -->
                                 <!--Fill in your text below (outside the 
comment block).       -->

                                 <projectManager> </projectManager>

                                 <!-- Fill in the URLS you would like use 
for your main         -->
                                 <!-- home page. This could be either your 
Trac page or         -->
                                 <!-- your static page (if you have one).  
                    -->
                                 <!-- For example, for SYMPHONY, you would 
put                  -->
                                 <!--                      -->
                                 <!--                      -->
                                 <!--<projectHomePage>         -->
                                 <!--   
https://projects.coin-or.org/SYMPHONY                   -->
                                 <!--</projectHomePage>    -->
                                 <!--                      -->
                                 <!--Fill in your text below (outside the 
comment block).       -->

                                 <projectHomePage> </projectHomePage>

                                 <!-- Fill in the name of the license your 
project uses         -->
                                 <!-- and a link to its page on 
www.opensource.org              -->
                                 <!-- For example, if you use the CPL, you 
would put            -->
                                 <!--                      -->
                                 <!--<projectLicense>          -->
                                 <!--   Common Public License 1.0    -->
                                 <!--</projectLicense>   -->
                                 <!--<projectLicenseURL>      -->
                                 <!--   
http://www.opensource.org/licenses/cpl1.0.php           -->
                                 <!--</projectLicenseURL>      -->
                                 <!--                      -->
                                 <!--Fill in your text below (outside the 
comment block).       -->

                                 <projectLicense></projectLicense>
                                 <projectLicenseURL></projectLicenseURL>

                                 <!-- Below, you can list other COIN 
projects your project      -->
                                 <!-- depends on. These are listed one by 
one, as in the        -->
                                 <!-- following example for SYMPHONY:      
      -->
                                 <!--                      -->
                                 <!--<coinLinkedProjects>      -->
                                 <!--                      -->
                                 <!--   <coinProject>  -->
                                 <!--      <projectName>     -->
                                 <!--         CoinUtils    -->
                                 <!--      </projectName>      -->
                                 <!--   </coinProject>   -->
                                 <!--                      -->
                                 <!--   <coinProject>  -->
                                 <!--      <projectName>     -->
                                 <!--         Cgl                      -->
                                 <!--      </projectName>      -->
                                 <!--   </coinProject>   -->
                                 <!--                      -->
                                 <!--   <coinProject>  -->
                                 <!--      <projectName>     -->
                                 <!--         Osi                      -->
                                 <!--      </projectName>      -->
                                 <!--   </coinProject>   -->
                                 <!--                      -->
                                 <!--   <coinProject>  -->
                                 <!--      <projectName>     -->
                                 <!--         Clp                      -->
                                 <!--      </projectName>      -->
                                 <!--   </coinProject>   -->
                                 <!--                      -->
                                 <!--</coinLinkedProjects>       -->
                                 <!--                      -->
                                 <!--Fill in your text below (outside the 
comment block).       -->

                                 <coinLinkedProjects>
                                                 <coinProject>
 <projectName></projectName>
                                                 </coinProject>
                                 </coinLinkedProjects>

                                 <!-- Below, you can list other packages 
your project           -->
                                 <!-- either requires or can optionally 
link to. These are      -->
                                 <!-- one by one, as in the following 
example:                  -->
                                 <!--                      -->
                                 <!--<otherLinkedPackages>       -->
                                 <!--                      -->
                                 <!--   <otherPackage>   -->
                                 <!--      <packageName>     -->
                                 <!--         GLPK  -->
                                 <!--      </packageName>      -->
                                 <!--      <packageURL>    -->
                                 <!--         
http://www.gnu.org/software/glpk/                 -->
                                 <!--      </packageURL>     -->
                                 <!--      <requiredOrOptional>   -->
                                 <!--         Optional   -->
                                 <!--      </requiredOrOptional>     -->
                                 <!--   </otherPackage>    -->
                                 <!--                      -->
                                 <!--   <otherPackage>   -->
                                 <!--      <packageName>     -->
                                 <!--         GNU Readline       -->
                                 <!--      </packageName>      -->
                                 <!--      <packageURL>    -->
                                 <!--      </packageURL>     -->
                                 <!--      <requiredOrOptional>   -->
                                 <!--         Optional   -->
                                 <!--      </requiredOrOptional>     -->
                                 <!--   </otherPackage>    -->
                                 <!--                      -->
                                 <!--   <otherPackage>   -->
                                 <!--      <packageName>     -->
                                 <!--         GNU History      -->
                                 <!--      </packageName>      -->
                                 <!--      <packageURL>    -->
                                 <!--      </packageURL>     -->
                                 <!--      <requiredOrOptional>   -->
                                 <!--         Optional   -->
                                 <!--      </requiredOrOptional>     -->
                                 <!--   </otherPackage>    -->
                                 <!--                      -->
                                 <!--</otherLinkedPackages>        -->
                                 <!--                      -->
                                 <!--Fill in your text below (outside the 
comment block).       -->

                                 <otherLinkedPackages>
                                                 <otherPackage>
 <packageName></packageName>
 <packageURL></packageURL>
 <requiredOrOptional></requiredOrOptional>
                                                 </otherPackage>
                                 </otherLinkedPackages>

                                 <!-- Below, you can list the programming 
language(s) used in   -->
                                 <!-- the project. For example:   -->
                                 <!--<projectLanguage>C</projectLanguage>  
                    -->
                                 <!--                      -->
                                 <!--Fill in your text below (outside the 
comment block).       -->

                                 <projectLanguage></projectLanguage>


                                 <!--The following fields describe the 
development status       -->
                                 <!--of the project.  -->
                                 <!--                      -->
                                 <!--Fill in your text below (outside the 
comment block).       -->

                                 <developmentStatus>

                                                 <!--If you are actively 
managing your project, use     -->

 <activityStatus>Active</activityStatus>

                                                 <!--The maturity level is 
determined during project    -->
                                                 <!--review and should 
have been reported to you.       -->
                                                 <!--See 
http://www.coin-or.org/faqs.html#q18 for       -->
                                                 <!--more information on 
maturity level.                -->
                                                 <!--Fill it in like this: 
                             -->
                                                 <!--          -->
 <!--<maturityLevel>5</maturityLevel>                   -->
                                                 <!--          -->

 <maturityLevel></maturityLevel>

                                                 <!--If you have 
versioning and releases, you should    -->
                                                 <!--fill in your latest 
stable version number here.    -->
                                                 <!--See 
http://www.coin-or.org/faqs.html#q19 for       -->
                                                 <!--more information on 
version numbers.               -->
                                                 <!--Fill it in like this: 
                             -->
                                                 <!--          -->
 <!--<stableVersionNumber>5.1</stableVersionNumber>     -->
                                                 <!--          -->

 <stableVersionNumber></stableVersionNumber>

                                                 <!--If you have 
versioning and releases, you should    -->
                                                 <!--fill in your latest 
stable release number here.    -->
                                                 <!--See 
http://www.coin-or.org/faqs.html#q19 for       -->
                                                 <!--more information on 
version numbers.               -->
                                                 <!--Fill it in like this: 
                             -->
                                                 <!--          -->
 <!--<releaseVersionNumber>5.1.4</releaseeVersionNumber>-->
                                                 <!--          -->

 <releaseNumber></releaseNumber>

                                 </developmentStatus>

                                 <!--Below, you can list the platforms on 
which your            -->
                                 <!--project has been tested. Again, these 
are listed one       -->
                                 <!--by one. There are fields for both 
operating system and     -->
                                 <!--compiler. Here is an example for 
SYMPHONY                  -->
                                 <!--                      -->
                                 <!--<testedPlatforms>   -->
                                 <!--                      -->
                                 <!--   <platform>  -->
                                 <!--      <operatingSystem>Microsoft 
Windows</operatingSystem> -->
                                 <!--      <compiler>MSVC++/cl</compiler>  
                    -->
                                 <!--   </platform>  -->
                                 <!--                      -->
                                 <!--   <platform>  -->
                                 <!--      <operatingSystem>Microsoft 
Windows</operatingSystem> -->
                                 <!--      <compiler>CYGWIN/cl</compiler>  
                    -->
                                 <!--   </platform>  -->
                                 <!--                      -->
                                 <!--   <platform>  -->
                                 <!--      <operatingSystem>Microsoft 
Windows</operatingSystem> -->
                                 <!--      <compiler>CYGWIN/gcc</compiler> 
                     -->
                                 <!--   </platform>  -->
                                 <!--                      -->
                                 <!--   <platform>  -->
                                 <!--      <operatingSystem>Microsoft 
Windows</operatingSystem> -->
                                 <!--      <compiler>MSys/gcc</compiler>   
                  -->
                                 <!--   </platform>  -->
                                 <!--                      -->
                                 <!--   <platform>  -->
                                 <!-- 
<operatingSystem>Linux</operatingSystem> -->
                                 <!--      <compiler>gcc</compiler>     
-->
                                 <!--   </platform>  -->
                                 <!--                      -->
                                 <!--   <platform>  -->
                                 <!--      <operatingSystem>Mac 
OSX</operatingSystem>           -->
                                 <!--      <compiler>gcc</compiler>     
-->
                                 <!--   </platform>  -->
                                 <!--                      -->
                                 <!--   <platform>  -->
                                 <!--      <operatingSystem>Solaris 
x86</operatingSystem>       -->
                                 <!--      <compiler>gcc</compiler>     
-->
                                 <!--   </platform>  -->
                                 <!--                      -->
                                 <!--   <platform>  -->
                                 <!--      <operatingSystem>Solaris 
x86</operatingSystem>       -->
                                 <!--      <compiler>sunpro</compiler>     
           -->
                                 <!--   </platform>  -->
                                 <!--                      -->
                                 <!--</testedPlatforms>                -->
                                 <!--                      -->
                                 <!--Fill in your text below (outside the 
comment block).       -->

                                 <testedPlatforms>

                                                 <platform>
 <operatingSystem></operatingSystem>
 <compiler></compiler>
                                                 </platform>

                                 </testedPlatforms>
 
                                 <projectCategories>
                                                 <!-- Start  of 
projectCategories block   -->
 
                                                 <!--Below is the list of 
COIN-OR project categores.    -->
                                                 <!--Simply "un-comment" 
any categories that apply to   -->
                                                 <!--your project.      
-->
 
                                                 <!--   <category>      
-->
                                                 <!--        Development 
tools                          -->
                                                 <!--    </category>       
        -->
                                                 <!--    <category>        
 -->
                                                 <!--        Graphs        
 -->
                                                 <!--    </category>       
        -->
                                                 <!--    <category>        
 -->
                                                 <!--        Interfaces    
                       -->
                                                 <!--    </category>       
        -->
                                                 <!--    <category>        
 -->
                                                 <!-- Metaheuristics       
 -->
                                                 <!--    </category>       
        -->
                                                 <!--    <category>        
 -->
                                                 <!--        Modeling 
systems                           -->
                                                 <!--    </category>       
        -->
                                                 <!--    <category>        
 -->
                                                 <!--        Optimization 
convex non-differentiable     -->
                                                 <!--    </category>       
        -->
                                                 <!--    <category>        
 -->
                                                 <!--        Optimization 
deterministic linear continuous -->
                                                 <!--    </category>       
        -->
                                                 <!--    <category>        
 -->
                                                 <!--        Optimization 
deterministic linear discrete -->
                                                 <!--    </category>       
        -->
                                                 <!--    <category>        
 -->
                                                 <!--        Optimization 
deterministic nonlinear       -->
                                                 <!--    </category>       
        -->
                                                 <!--    <category>        
 -->
                                                 <!--        Optimization 
deterministic nonlinear discrete -->
                                                 <!--    </category>       
        -->
                                                 <!--    <category>        
 -->
                                                 <!--        Optimization 
deterministic semidefinite continuous -->
                                                 <!--    </category>       
        -->
                                                 <!--    <category>        
 -->
                                                 <!--        Optimization 
stochastic                    -->
                                                 <!--    </category>       
        -->
                                                 <!--    <category>        
 -->
                                                 <!--        Optimization 
utility                       -->
                                                 <!--    </category>       
        -->
 
                                                 <!-- End of 
projectCategories block                    -->
                                 </projectCategories>
 

                                 <!-- End of projectBasics block     -->

                 </projectBasics>

                 <!--Below, you can specify the links for the left-hand 
side menu.      -->
                 <!--Note that these are optional, so if there is a blank, 
there will   -->
                 <!--be no corresponding menu item              -->
                 <!--              -->
                 <!--For SYMPHONY, this block would look like this:   -->
                 <!--              -->
                 <!--<leftMenuLinks>              -->
                 <!--              -->
                 <!--   <documentation>              -->
                 <!--      http://www.coin-or.org/SYMPHONY/man-5.1   -->
                 <!--   </documentation>              -->
                 <!--              -->
                 <!--   <sourceCodeDownload>              -->
                 <!--      http://www.coin-or.org/download/source/SYMPHONY 
             -->
                 <!--   </sourceCodeDownload>              -->
                 <!--              -->
                 <!--   <binaryDownload>              -->
                 <!--      http://www.coin-or.org/download/binary/SYMPHONY 
             -->
                 <!--   </binaryDownload>              -->
                 <!--              -->
                 <!--   <mailingList>              -->
                 <!--      
http://list.coin-or.org/mailman/listinfo/coin-symphony       -->
                 <!--   </mailingList>              -->
                 <!--</leftMenuLinks>              -->
                 <!--              -->
                 <!--Fill in your text below (outside the comment block).  
            -->

                 <leftMenuLinks>

                                 <documentation></documentation>

                                 <sourceCodeDownload></sourceCodeDownload>

                                 <binaryDownload></binaryDownload>

                                 <mailingList></mailingList>

                 </leftMenuLinks>

                 <!-- End of projectData block              -->
</projectData>
_______________________________________________
Project-managers mailing list
Project-managers at list.coin-or.org
http://list.coin-or.org/mailman/listinfo/project-managers

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://list.coin-or.org/pipermail/project-managers/attachments/20070918/eef32af1/attachment-0001.html


More information about the Project-managers mailing list