It appears that SourceForge is currently experiencing problems with their MySQL database server. Certain parts of the openFIRST website may not be functioning properly as a result.

openFIRST Portal System

» Home | » About openFIRST | » Documentation | » Downloads | » Volunteers | » Bug Reports | » Contact Us

Welcome to the openFIRST Portal Development Website!


openFIRST Powered
?

What is openFIRST?

The openFIRST Portal System is an integrated set of modules which may be used together to create or enhance a web site. It is directed towards teams participating in the FIRST robotics competition. The openFIRST Portal System is a completely student-developed project that has had contributions from a wide variety of teams from Brasil, Canada and the United States.

?

Developers?

openFIRST is developed by a number of students from the FIRST Robotics competition teams #1006, #1049, #781, #1075, #1501, #1227, and #1257. You may read more about the developers here. To learn how to contribute to the project, and for a technical reference about writing modifications / patches / enhancements for the openFIRST system, read the openFIRST Contributor's HOWTO. New contributors are always welcome.

gear

USFIRST Robotics

USFIRST is the largest North American robotics competition that has over 800 teams and many competitions yearly. Read more.

USFIRST Logo

openFIRST was developed with:



XHTML 1.0
Apache
Microsoft IIS
Sambar
PHP
MySQL
(Other databases are also supported)

FIRST Top Site

Bugzilla Stats

View Source: /doc/tut/howto/technology.php

<h1>The Technologies</h1>
 <ul>
  <li><a href="#email">E-mail</a></li>
  <li><a href="#webbrowser">The web browser</a></li>
  <li><a href="#html">HTML</a></li>
  <li><a href="#css">CSS</a></li>
  <li><a href="#bugzilla">Bugzilla</a></li>
  <li><a href="#updatesystem">openFIRST Update System</a></li>
  <li><a href="#shellaccess">Shell Access</a></li>
  <li><a href="#php">PHP</a></li>
  <li><a href="#asp">ASP</a></li>
  <li><a href="#database">MySQL/Database Software</a></li>
  <li><a href="#cvs">CVS</a></li>
  <li><a href="#subversion">Subversion</a></li>
  <li><a href="#profiles">Volunteer Profiles</a></li>
  <li><a href="#hackergotchi">Hackergotchi</a></li>
 </ul>
 
 <h2><span id="email">E-mail</span></h2>
 <h3>Applies to: All</h3>
 
 <p>The openFIRST project maintains the <a href="http://www.openfirst.org/">openfirst.org</a> e-mail addresses (eg. tim [at] openfirst.org).  These addresses are most often set to forward to a contributors personal e-mai
l account by an administrator.  E-mail addresses are assigned as firstname [at] openfirst.org.  If you did not get an e-mail address assigned to you when you joined, or would like to change the address that mail is forwarded to, contact an administrator.</p> 
 
 <p>A series of mailing lists is also maintained.  See the <a href="information.php#mailinglists">Mailing lists heading</a> of the <a href="information.php">Information and Resources section</a> for more information about these mailing lists.</p>
 
 <h2><span id="webbrowser">The web browser</span></h2>
 <h3>Applies to: All</h3>
 <p>Since the openFIRST project is inherently web-based it is expected that contributors have at least a basic understanding of the usage of a web browser.  It is recommended especially for those working with code/html to make use of the <a href="http://w
ww.mozilla.com/">Firefox</a> web browser.  There are a wide variety of plugins which are of use to website developers and general users (in Firefox, see <b>Tools</b> - <b>Extensions</b> - <b>Get More Extensions</b> for a catalogue of the available
 Firefox extensions).</p>
 
<h3>Applies to: Developer, Patch Writer, Webmaster, Documentation Writer</h3>
<p>Plugins that are of particular note for Firefox include these:</p>

<ul>
 <li><b>Live HTTP Headers</b> - View HTTP headers of a page and while browsing.</li>
 <li><b>netcrafttoolbar</b> - Blocks Phishing Sites (can also be used to look up in depth information about where a website is hosted, by whom, etc which may be of particular use for detecting obscure configuration problems  that are applicable to all use
rs of a particular web host).</li>
 <li><b>Checky</b> - Easy to use interface to many free and commercial online validation and analysis services.  Validate and analyse HTML, XHTML, CSS, RDF, RSS, XML, WAI, Section 508, P3P, hyperlinks, metadata and many more.  Adds a context and tools men
u.</li>
 <li><b>Fangs Screen Reader Emulator</b> - Renders a text version of a web page similar to screen reader output.</li>
 <li><b>LinkChecker</b> - Checks the validity of links on any webpage.</li>
 <li><b>View formatted source</b> - View formatted and rendered source code</li>
 <li><b>View Rendered Source</b> - Displays Color Coded and Styled Rendered Source</li>
 <li><b>Web Developer</b> - Adds a menu and a toolbar with various web developer tools.</li>
</ul>

 <h2><span id="html">HTML</span></h2>
 <h3>Applies to: Administrator, Developer, Patch Writer, Webmaster, Documentation Writer</h3> 
 <p>The openFIRST project tries when possible to produce valid HTML (matching the particular doctype of any given document).  In most cases, the standard currently used is HTML 4.  Pages should have valid HTML and should be checked with the W3C HTML Valid
ator at <a href="http://validator.w3.org/">http://validator.w3.org/</a> or a similar tool.  It is suggested that you be familiar with HTML, and the HTML standard itself available at <a href="http://w3.org/MarkUp/">http://w3.org/MarkUp/</a> rather than jus
t blindly following a validator.</p>
 
 <p>The openFIRST project site, and the software created by the project should be as accessible as possible.  More information about making web pages accessible is available from the Web Accessibility Initiative at <a href="http://w3.org/WAI/">http://w3.o
rg/WAI/</a>.  An Accessibility testing tool called Bobby&trade; is available at <a href="http://bobby.watchfire.com/bobby/html/en/index.jsp">http://bobby.watchfire.com/bobby/html/en/index.jsp</a>.</p>
 
 <h2><span id="css">CSS</span></h2>
 <h3>Applies to: Administrator, Developer, Patch Writer, Webmaster</h3> 
 <p>The openFIRST project tries when possible to sue valid CSS when possible.  The current version of the Cascading Style Sheets standard that is used is CSS 2.  It is recommended that stylesheets and pages be checked using the CSS validator at <a href="h
ttp://jigsaw.w3.org/css-validator/">http://jigsaw.w3.org/css-validator/</a> or a similar tool.  It is suggested that you use the CSS standard for reference; the standard is available at <a href="http://w3.org/Style/CSS/">http://w3.org/Style/CSS/</a>.</p>
 
 <p>Where possible, CSS should be used to make web pages more accessible.  More information about making web pages accessible is available from the Web Accessibility Initiative at <a href="http://w3.org/WAI/">http://w3.org/WAI/</a>.  An Accessibility test
ing tool called Bobby&trade; is available at <a href="http://bobby.watchfire.com/bobby/html/en/index.jsp">http://bobby.watchfire.com/bobby/html/en/index.jsp</a>.</p>
 
 <h2><span id="bugzilla">Bugzilla</span></h2>
 <h3>Applies to: Administrator, Developer, Documentation Writer, Patch Writer, Webmaster</h3>
 <p>Bugzilla (<a href="http://bugzilla.openfirst.org/">http://bugzilla.openfirst.org/</a>) keeps track of bug reports and feature requests for both source code and documentation.  Issues of an administrative nature may also be posted on Bugzilla.  As a co
ntributor to the openFIRST project you should register for a Bugzilla account using your @openfirst.org e-mail address.  Only e-mail addresses that are @openfirst.org show up in the bug crusher statistics on the openfirst.org site and installations of the
 openFIRST System.  To be credited as having crushed a bug, the bug must be finished (eg marked CLOSED, FIXED, etc.) but not DUPLICATE and the bug must be assigned to you at the time it is closed.</p>
 
 <p>Jobs which are suitable for those people with only an entry level of experience with the openFIRST project are (or should be) <a href="http://bugzilla.openfirst.org/buglist.cgi?query_format=specific&amp;order=relevance+desc&amp;bug_status=__open__&amp
;product=&amp;content=%5BJJ%5D">marked with the [JJ] tag</a>.  Junior Jobs are typically expected to take under an hour to research/isolate (if required) and implement.</p>

 <p>Automated bug reports are filed by openFIRST installations and are clearly marked as such.  You, as one who browses Bugzilla should change the subject of Automated bug reports to better reflect their content and/or mark them as DUPLICATE if applicable
.  Automated bug reports are reported through <a href="http://bugzilla.openfirst.org/openfirst/">http://bugzilla.openfirst.org/openfirst/</a> and bug crusher statistics are available at <a href="http://bugzilla.openfirst.org/openfirst/bugcrushers.php">htt
p://bugzilla.openfirst.org/openfirst/bugcrushers.php</a>.  The style sheet and design information for the Bugzilla site is present within the Subversion repository in <b>trunk/www/bugzilla</b>.  Upgrades to Bugzilla may requir
e remaking these templates in order for the Bugzilla site to function as expected.</p>

 <h2><span id="updatesystem">openFIRST Update System</span></h2>
 <h3>Applies to: Administrator, Developer, Patch Writer, Webmaster</h3>
 
 <p>The openFIRST Update System is currently under development at <a href="http://update.openfirst.org/test/">http://update.openfirst.org/test/</a>.  The goal of the system is to create a simple interface for end users to remotely install and manage any n
umber of openFIRST installations.  The system will be able to automate installation of updates and security patches, and communicates directly with the end-user's web server, preventing users on slow connections from having to undergo the lengthy download
 process to get the full openFIRST system.  Third parties will be able to submit packages to be managed by the openFIRST Update System, and can mark security updates, new versions, etc. which will notify end users who have set their preferences as such.</
p>
  
 <p>The openFIRST Update System resides in the <b>update</b> module of the openFIRST CVS repository but will be moved to Subversion in the future.</p>
 
 <h2><span id="shellaccess">Shell Access</span></h2>
 <h3>Applies to: Administrator, Developer, Webmaster</h3>
 <p>All developers, webmasters, and administrators are able to access the SourceForge.net Project Shell Server via SSH at <b>shell.sourceforge.net</b>.  A suitable SSH client for Windows is PuTTY, and is available at <a href="http://www.chiark.greenend.or
g.uk/~sgtatham/putty/download.html">http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html</a>; many other operating systems already include an SSH client, on UNIX or Linux consult <tt>man ssh</tt> for more information.  To login, you should use 
your SourceForge.net username and passsword.  It is recommended, for the sake of convenience, that upon logging into the system for the first time, you perform these command:</p>
 
 <p><tt>ln -s /home/groups/o/op/openfirst openfirst</tt></p>
 
 <p>Doing so will create a symbolic link in your home directory to the openFIRST project directory on the shell server.  Certain instructions throughout this document will assume that the symbolic link exists.</p>
 
 <p>Administrators and webmasters of other openFIRST sites may be able to access them via SSH using a different login name and password.  If you require shell access to one of these other sites, or to the SF.net Project Shell Server, contact an administra
tor.</p>
 
 <p>Some people may be used to updating the project web space through the Shell server.  For the openFIRST project you should not do this; you should instead make your changes in Subversion in <b>trunk/www/htdocs/</b>.  The project web space is automatically updated from Subversion ever hour.</p>
 
<p>...</p>

 <h2><span id="php">PHP</span></h2>
 <h3>Applies to: Administrator, Developer, Patch Writer, Release Technician, Webmaster</h3>
 <p><a href="http://www.php.net/">PHP</a> is the language used to write the vast majority of the code that openFIRST uses/distributes.  When writing/patching openFIRST software it may be assumed that the user is using at least PHP version 4.3 (released December, 2002).  PHP 3 and versions of PHP prior to 4.3.0 are no 
longer officially supported by the openFIRST project.  Some of the openFIRST servers run PHP4 versions and others run PHP5; when writing code, you should make sure it is tested with both PHP4 and PHP5 before being released.</p>

 <h2><span id="asp">ASP</span></h2>
 <h3>Applies to: Administrator, Developer, Patch Writer, Release Technician, Webmaster</h3>
 <p>Very little of the project is written in ASP at the moment, and the ASP versions have been unmaintained for many years now. The original creator of the ASP modules graduated before the project had any real plan for replacing graduated developers.  There are no plans to continue development in ASP.</p>
  
 <h2><span id="database">MySQL/Database Software</span></h2>
 <h3>Applies to: Administrator, Developer, Webmaster</h3>
 <p>When programming, use the openFIRST database wrappers rather than directly using any database-specific functions.</p>

<p>...</p> 

 <h2><span id="cvs">CVS</span></h2>
 <h3>Applies to: Administrator, Developer, Documentation Writer, Release Technician, Webmaster</h3>
 <p>CVS was used by the openFIRST project for version control.  It is being phased out in favour of Subversion.  You may refer to the <a href="http://sourceforge.net/cvs/?group_id=78233">About CVS</a> documentation on the Source Forge Project page.</p>

 <h2><span id="subversion">Subversion</span></h2>
 <h3>Applies to: Administrator, Developer, Documentation Writer, Release Technician, Webmaster</h3>
 <p>Subversion is the tool used by the openFIRST project for version control.  You may refer to the <a href="http://sourceforge.net/svn/?group_id=78233">About Subversion</a> documentation on the Source Forge Project page.</p>

 <h2><span id="profiles">Volunteer Profiles</span></h2>
 <h3>Applies to: All</h3>
 <p>Those wishing to create a <a href="http://www.openfirst.org/developers/">volunteer profile</a> (previously called developer profile) must check out the www module from CVS and add their profile to the www/htdocs/developer directory then edit index.php
 of that directory in order to have their profile listed.  Alternatively, contact a developer/administrator to have them do this on your behalf.   Information about the "Hackergotchi" section of the Volunteer Profiles follows.</p>


 <h2><span id="hackergotchi">Hackergotchi</span></h2>
 <h3>Applies to: All</h3>
 <p>Those wishing to create a &quot;Hackergotchi&quot; character may do so.   The dimensions recommended are 80 pixels by 80 pixels.  To have the Hackergotchi used for news postings, etc. on the main site, using CVS add it to the www/htdocs/image/hackergo
tchi directory.  The Hackergotchi image should be named using your SourceForge.net username and should be of type PNG, JPEG or GIF; the filename must be all lowercase letters.  A tutorial on how to create Hackergotchi images is available at <a href="http:
//www.livejournal.com/users/wouterverhelst/21322.html">http://www.livejournal.com/users/wouterverhelst/21322.html</a>.</p>

<p><center><a href="roles.php">Previous</a> | <a href="index.php">Table of Contents</a> | <a href="glossary.php">Next</a></center></p>

© Copyright 2002-2003 by the openFIRST Development Team. All rights reserved.

. Show Source

openFIRST Powered SourceForge.net