site/about.html (101 lines of code) (raw):

<!doctype html> <html lang=''> <head> <meta charset='utf-8'> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="stylesheet" href="styles.css"> <script src="js/jquery.js" type="text/javascript"></script> <script src="js/script.js" type="text/javascript"></script> <title>About Apache Projects Directory</title> </head> <body> <div id="logo"><h1><div style="padding-top: 30px;">About This Site</div></h1></div> <div id='cssmenu'> <ul> <li><a href='.'><span>Home</span></a></li> <li><a href='committees.html'><span>Committees</span></a></li> <li><a href='projects.html'><span>Projects</span></a></li> <li><a href='releases.html'><span>Releases</span></a></li> <li class='last'><a href='timelines.html'><span>Timelines</span></a></li> <li style="background: none !important"><input type="text" style="margin-top: 20px;" onkeypress="checkKeyPress(event, this);" placeholder="Search..."/></li> <li style="float: right;" class='active'><a href='about.html'><span>About</span></a></li> <!--li style="background: none; float: right;"><a href="edit/"><img title="Edit project data" style="vertical-align: middle; margin-top: -5px; height: 24px; width: 24px;" src="images/edit.png"/></a></li--> </ul> </div> <div> <h1>About This Website</h1> <p> This website is maintained by the <span itemscope itemprop="author" itemtype="https://schema.org/Organization"> <span itemprop="name"><a itemprop="url" href="https://community.apache.org/">Apache Community Development PMC</a></span> who works on the <span itemprop="email">dev@community.apache.org</span> <span itemscope itemtype="https://schema.org/ContactPage"><a itemprop="url" href="https://community.apache.org/lists.html">archived mailing list</a></span>. </span> </p> <p> The primary content for this website is in static HTML, and uses a variety of cronjobs, JavaScript, and other tools to dynamically display the data. <br/> The underlying sources are stored in a Subversion repository at: <pre itemscope itemtype="https://schema.org/SoftwareSourceCode" style="border:1px solid #999; padding: 12px; margin: 1em 7px 1em 7px;">svn co <a itemprop="codeRepository" href="https://svn.apache.org/repos/asf/comdev/projects.apache.org/trunk/">https://svn.apache.org/repos/asf/comdev/projects.apache.org/trunk/</a></pre> <br/> Changes checked into the HTML are reflected immediately on the production server. </p> <h2>DOAP files</h2> <p> The data for individual projects is stored in <a href="doap.html">DOAP files</a>. (<b>D</b>escription <b>O</b>f <b>A</b> <b>P</b>roject).<br> Project DOAP files are created and maintained by PMCs. </p> <p> There is a <a href="doap.html">description of DOAP files</a>. This includes a link to a tool to create an initial DOAP for a project. </p> <p> Once a DOAP has been created, it should be stored in a suitable place in a PMC repo.<br> Then add the URL for the DOAP to the file <a href="https://svn.apache.org/repos/asf/comdev/projects.apache.org/trunk/data/projects.xml">data/projects.xml</a> in SVN.<br> If using Git, please ensure the URL points to the plain DOAP file, not some HTML version. The raw link will look something like:<br> <code>https://raw.githubusercontent.com/apache/{projectrepo}/main/doap_{project}.rdf</code> </p> <h2>How The Code Works</h2> <p>The data about Apache projects on this site is generated at least daily by cronjobs running Python scripts from various data sources. Various cronjobs check authoritative ASF data sources for updates, and then cache data needed by this website (and possibly other websites) in a variety of JSON files that are checked into a Subversion repository for safety and simplicity of backups. This site then uses JavaScript and a variety of visualization tools to dynamically display charts and listings of Apache project metadata. <ol> <li>Organizational information about Apache project <a href="https://www.apache.org/foundation/#who-runs-the-asf">committees</a> and <a href="https://home.apache.org/phonebook.html">people</a>,</li> <li><a href="pmc_rdf.html">PMC RDF data files</a> in the <a href="https://svn.apache.org/repos/asf/comdev/projects.apache.org/trunk/data/committees">data/committees</a> directory. <br> PMCs can maintain their own data files instead: replace the the default "committees/pmc-name.rdf" entry with your URL in this file: <br> <a href="https://svn.apache.org/repos/asf/comdev/projects.apache.org/trunk/data/committees.xml">https://svn.apache.org/repos/asf/comdev/projects.apache.org/trunk/data/committees.xml</a> </li> <li>Project DOAP files listed in <a href="https://svn.apache.org/repos/asf/comdev/projects.apache.org/trunk/data/projects.xml">https://svn.apache.org/repos/asf/comdev/projects.apache.org/trunk/data/projects.xml</a><br/> <a href="doap.html">DOAP files</a> are maintained by the projects themselves. </li> <li>Technical details about the code are in <a href="https://svn.apache.org/repos/asf/comdev/projects.apache.org/trunk/STRUCTURE.txt">STRUCTURE.txt</a> </li> </ol> <p>You can ask us questions on the <a href="mailto:dev@community.apache.org">dev@community.apache.org</a> mailing list, or <a href="https://lists.apache.org/list.html?dev@community.apache.org">read the mail archives</a> online. To report a specific problem with the website, create a <a href="https://issues.apache.org/jira/issues/?jql=project+%3D+COMDEV+AND+component+%3D+%22Projects+Tool%22">COMDEV Jira issue in the "Projects" component</a>. </p> <h1>Learn More About The ASF</h1> <p>This site is one of a galaxy of sites where you can find out more information about the Apache Software Foundation (ASF). See also: </p> <ul> <li><a href="https://www.apache.org/foundation/">The Apache Software Foundation</a> - all about the ASF</li> <li><a href="https://community.apache.org/">Apache Community Development</a> - How to get involved and stay involved</li> <li><a href="https://www.apache.org/dev/">Technical information about tools</a> - Pointers to the various tools (mail, SVN, git, etc.) Apache projects use</li> <li><a href="https://helpwanted.apache.org/">Help Wanted</a> - Find simple tasks to start contributing to an Apache project today</li> <li><a href="https://whimsy.apache.org/board/minutes/">Board of Director Minutes</a> - for official records of the ASF board and all projects</li> </ul> </div> <div id="footer"> Managed by the <a href="https://community.apache.org/">Apache Community Development Project</a>.<br/> Copyright&copy; the Apache Software Foundation. Licensed under the <a rel="license" href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a><br/> Apache&reg; and the multicolor feather logo are <a href="https://www.apache.org/foundation/marks/list/">trademarks</a> of The Apache Software Foundation. </div> </body> </html>