[Community-cvs] www/2005 participate.html, NONE, 1.1 webstandards.html, NONE, 1.1
robla at helixcommunity.org robla at helixcommunity.orgUpdate of /cvsroot/community/www/2005 In directory cvs-new:/tmp/cvs-serv646 Added Files: participate.html webstandards.html Log Message: Adding participation and webstandards documents here in attempt to centralize active documents owned by this team. --- NEW FILE: webstandards.html --- <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1"> <title>Web Content Standards</title> </head> <body> <h2>Web Content Standards for HelixCommunity.org</h2> <br> Currently, there's a lot of content on HelixCommunity.org, and a lot of authors of that content. By and large, this is a good thing. Since project owners have control of their own webspaces, they are able to solve the documentation needs of their sub-communities without relying on central management.<br> <br> One thing to be mindful of in publishing new web documents is that the URLs for those documents will be the target of hyperlinks from other web documents. The author of the original document has no control of who, where, or how the person linking to them will do this. However, those inbound links are almost always a very good thing.<br> <br> As anyone who has ever gotten a "404 - Document Not Found" error will testify (which constitutes practically everyone who has ever encountered a web browser), it can be very frustrating. Most of the time, these 404s are actually the result of a URL that has changed, and are entirely preventable by the recipient of the inbound link. This is the crux of <a href="http://www.w3.org/Provider/Style/URI">Cool URIs Don't Change</a>, a position paper written by Tim Berners-Lee describing why URL/URI stability is important.<br> <br> The webmasters of HelixCommunity.org are committed to ensuring that 404 errors are a rare instance. In order to make such a mandate practicable, we're instituting the following policies for HelixCommunity.org:<br> <ul> <li>Temporal URLs: For the vast majority of web pages, preface the URL with the year. For example, the URL to this document is <a href="https://wideopen.helixcommunity.org/2003/webstandards">https://wideopen.helixcommunity.org/2003/webstandards</a>. This creates an automatic hierarchy that refreshes annually, thus making maintenance simpler.</li> <li>Non-temporal URLs: When there's a very high degree of confidence that a URL is of a timeless nature (one that should point to actively maintained documentation 5-10 years from now), only then is it acceptable to drop the year from the URL. Example: <a href="https://player.helixcommunity.org/qa">https://player.helixcommunity.org/qa</a>.<span style="font-weight: bold;"> However</span>, such decisions should be subject to peer review, as well as webmaster approval. The procedure for implementing a non-temporal URL is to file an issue in <a href="https://bugs.helixcommunity.org/enter_bug.cgi?product=community">the Helix Community bug tracker</a> with the proposed URL, the proposed content for that URL, and a justification. Explicit acknowlegement by a designated webmaster is required before creating new URLs. Failure to follow procedure can result in a loss of CVS write access.</li> <li>File extensions: most modern webservers (including the webserver at helixcommunity.org) have the ability to serve webpages without requiring the file extension in the URL. Therefore, even though this page is currently at webstandards.html and that the ".html" portion could be included, the URL to this page is still only ends with "webstandards"<br> </li> </ul> All of the policies above are rooted in the principles described in the W3C position paper <a href="http://www.w3.org/Provider/Style/URI">Cool URIs Don't Change</a>.<br> <a name="redirect"></a> <h2>Redirect syntax</h2> Sometimes, it's highly desireable to move a document to a new location, and have a transparent redirect mechanism for making that work. The current site infrastructure has the following syntax which can be used. To redirect a web page, replace the HTML in the file with the following one line command:<br> <code><?gforge:redirect to="https://foo.helixcommunity.org/2004/bar"?></code> <br> ...where https://foo.helixcommmunity.org/2004/bar is the location to redirect to. <h2>Designated Webmasters</h2> <ul> <li>Rob Lanphier<br> </li> <li>Send mail to <a href="mailto:feedback at helixcommunity.org">feedback at helixcommunity.org</a> to contact current webmasters</li> </ul> <br> </body> </html> --- NEW FILE: participate.html --- <html> <head> <title>Helix Community Participation</title> </head> <body> <h2>How You Can Participate!</h2> </div> <div class="app"> <div class="h3" id="subdomaincontent"> <p>There are many ways in which you can become involved in the Helix community. Even if you are not a programmer, there are ways that you can benefit from Helix and ways to help make Helix more useful to yourself and others.</p> <h3>Join the conversation</h3> <p>You can also find out what's all going on in the community by looking at <a href="https://community.helixcommunity.org/2005/forums">the mailing lists</a> or <a href="/2002/irc">joining our IRC channel</a>. A good mailing list to start off with is the <a href="https://helixcommunity.org/mail/?group_id=6">open-discuss</a> mailing list, where we discuss the overall operation of the Helix Community, including process improvements, website enhancements, and other ways of helping the community work together more efficiently. Once you become a regular contributor, you're invited to our regular telecon (currently every other Tuesday at 1pm Pacific Time). If you are interested in joining the telecon, and are already a regular participant in the community, RSVP to feedback at helixcommunity.org.</p> <h3>Trying it out and Posting Issues</h3> <p>Even if you are not a programmer, you can download <a href="https://player.helixcommunity.org/2004/downloads/">the compiled version of the Helix Player</a> and try it out, to see how it performs and works in your favorite environment with your favorite media.</p> <p>Anybody -- developers or end users -- should feel free to alert the Helix community of issues encountered with the Helix DNA, or ideas for ways to make the Helix DNA better for you. If you have run into something you would like to report, <a href="https://bugs.helixcommunity.org/?group_id=33">just let us know</a>!</p> <h3>Become a developer</h3> <p>If you'd like to learn more about becoming a developer, check out our <a href="https://helixcommunity.org/2002/intro/how-you-can-help">Developer Information for Helix</a>.</p> <h3>More information</h3> <p>The Helix Community Operations team manages this page. If you'd like to know more, please visit the <a href="https://community.helixcommunity.org">Helix Operations team project homepage</a>. </body> </html>