Difference between revisions of "Developer documentation"

From WormBaseWiki
Jump to navigationJump to search
Line 18: Line 18:
  
 
*[[Installing the Web Application|Installing the Web Application]] - ''Here's how to install the WormBase web application -- including Catalyst -- on your system DEPRECATED''  
 
*[[Installing the Web Application|Installing the Web Application]] - ''Here's how to install the WormBase web application -- including Catalyst -- on your system DEPRECATED''  
*[[HOWTO migrate a CGI|HOWTO migrate a CGI]] - ''quick overview of how to migrate an existing CGI into a Model, Controller, and View. Sparse''
 
 
*[[Website:Design Specifications|Requirements analysis / Design Specifications]]
 
*[[Website:Design Specifications|Requirements analysis / Design Specifications]]
  

Revision as of 00:44, 24 December 2010

This page contains information pertinent to employees of WormBase.

Project Management

Web Site Documentation

Development Milestones

Measuring Progress

July 14 - July 30th

  • Coronate Czars
  • Coding standards and best practices for CSS, Javascript, API in place
  • Release new pages to production powered by the new architecture (classic view only)
    • Variation, Protein, Sequence -- and maybe -- Gene
    • Todd to develop <strikethrough>deployment strategy</strikethrough>, hosting environment, and proxy configuration
    • Abby and Xiaoqi to work up templates and markup specific to the classic view
    • Norie to make requisite API changes as needed

July 30th - August 31st

  • Finish API development of critical classes
  • Finish migration of prominent CGI-based pages to new architecture and release into production (classic view only)
  • Solidify look-and-feel of new site: site map, browsing paths, design patterns, navigation
  • UI features to address/develop
    • Enhanced, high-performance search
    • External URL handling
    • Error trapping and reporting
    • Authorization/Authentication
    • Customizability
    • Configurable two-panel selector
    • Incorporation of old site elements like BLAST/BLAT
    • Top-level species pages (/celegans, eg) and UI clues for distinguishing them

December 22nd, 2010

  • Begin private review of new site
  • Launch surveys on UI

February 1st, 2011

  • Preview new site to SAB

May 1st, 2011

  • Public preview

June 1st, 2011

  • Public launch of new site at International Worm Meeting

Division of Labor

Duties, current as of July 2010.

Configuration Czar -- View and application configuration -- Norie

  • Keep configuration files neat, orderly, and documented
  • Create new configuration for hard-coded variables and UI elements when needed.
  • Enforce/evangelize configuration standards and formatting

CSS Czar -- Responsible for the maintenance of CSS files

  • Develop and document CSS best practices
  • Keep CSS files tidy and organized function
  • Enforce/evangelize standard CSS markup in templates

Javascript Czar -- Javascript use and maintenance

  • Develop and document Javascript best practices
  • Explore and advise on javascript plugins
  • Enforce/evangelize javascript standards and formatting

Template Czar -- Oversee template development

  • Develop and document template standards
  • Define and document shared template elements (ie tables, fields, widgets)
  • Keep template directory organized
  • Enforce/evangelize template standards

Controller Czar -- Maintain and develop new controllers as needed

  • Document existing controllers
  • Document logic flow through application
  • Develop new controller actions as requested/needed

WormBase::API Czar -- Oversee development of the external Model -- Norie

  • Develop and document API coding standards and best practices
  • Document shared API methods
  • Enforce/evangelize coding standards

Testing Czar -- Oversee testing of the web app -- Todd

  • Develop and document test requirements
  • Ensure adequate test coverage and performance
  • Develop global View and API tests
  • Stress Test app

Profiling Czar -- Track progress and performance of the web app -- Todd

  • See the Profiling documentation for additional details and progress.
  • Explore profiling options and discuss
  • Add dynamically configurable profiling
  • Identify and report bottlenecks
  • Develop caching mechanism of ajax-requested widgets

Coding standards and Best Practices

Architecture

Software platform

  • Application overview - A quick tour through the software platform, request flow, caching, etc
  • Configuration -- Application and view configuration: formatting and standards
  • WormBase::API -- The WormBase data model, maintained external to the web application
  • View -- Templating system, commom template elements, javascript, and CSS
  • Model -- The web application model; thin, glued to the external Model
  • Controller -- Overview of controller files and actions
  • Website:Software Platform -- The full software platform, including reverse proxy, webservers, and database node configuration
  • NFS at WormBase

Hardware platform

Administration

Updates

Routine Administration Tasks



Load balancing and Failover

Monitoring and Crises Management

Frozen Releases

Source Code Repositories

We use the distributed source code management system Mercurial. Projects are hosted on BitBucket.

How-To create, check out, and manage our repositories

Deprecated Documentation

The good word gone bad. Cruft. Lint. Maybe useful. Probably not.

Frozen Releases as Virtual Machines