Checklists and Processes

Checklists for Whiteboard processes

Purpose: to create a maintainable, repeatable, bite-sized process lists to reduce error rates and increase measurability across disciplines on our team.

Setting up a new computer

• First things first: install Apple's developer tools. These come with XCode typically, but here's a list of downloads just in case.
• Install Homebrew
• Install RVM if you're doing anything Ruby related
• Setup your LAMP stack
• Get your local sites run on arbitrary .dev domains, using something like this in your .conf file:

Alias /phpmyadmin /usr/local/share/phpmyadmin
  <Directory /usr/local/share/phpmyadmin/>
    Options Indexes FollowSymLinks MultiViews
    AllowOverride All
    Order allow,deny
    Allow from all
  </Directory>
<VirtualHost *:80>
ServerName dev
  DocumentRoot /Users/JonathanCutrell/Sites
  VirtualDocumentRoot /Users/JonathanCutrell/Sites/%-2
  UseCanonicalName Off
  <Directory "/Users/JonathanCutrell/Sites/*">
    AllowOverride All
    Order allow,deny
    Allow from all
  </Directory>
</VirtualHost>

• Consider modifying your dotfiles to make some defaults better
• Set up Backblaze
• Install Slack
• Install Chrome
• Make sure Git is installed and up to date. Try git -v, and then check out gitscm to see if it's old.
• Install Postgres.app
• Install the Heroku CLI, also called the "toolbelt"
• Install Transmit for SFTP, FTP, and S3 transfers
• Install NodeJS, which comes with NPM.
• Generate a keypair and add it to GitHub.

Note: Having issues with your sites directory not working? Make sure you uncomment the line that includes your user conf. It's commented out by default. httpd-userdir.conf - there's a line that includes the users/*.conf from your apache configs.

Pair Programming Session

• Come with a predefined task list
• Focus on a few tasks; both parties should take notes
• The purpose of notes will be to keep track of things that need to be addressed later, after the pairing session
• Look over this: http://guide.agilealliance.org/guide/pairing.html
• And this: https://teamgaslight.com/blog/guidelines-for-effective-pair-programming
• And then this: http://blog.codinghorror.com/pair-programming-vs-code-reviews/
• And maybe this? http://techcrunch.com/2012/03/03/pair-programming-considered-harmful/

Moral of the story: Pairing can be good, but let's keep it under control. It's not always the most important thing to do. Steve Wozniak says to work alone, for example. There is value in solving problems on your own. Some research says pairing is bloat; let's make sure we invest in pairing for learning and out of necessity, not simply out of principle.

Code Review Session

• Code review, especially for more junior developers, should be done on a semi-regular basis.

Go-live for the first time: WordPress, WP Engine

• To-do

Go-live for the first time: Rails, Heroku

• To-do

Pushing new features

• To-do

WordPress new project initiation

• To-do

Static new project initiation

• To-do

Rails new project initiation

• To-do

D+D Pre-Handoff Meeting Checklist

This meeting occurs between 50% and 75% of design phase. The following things should be validated as complete or to-be-completed.

• Assess basic feasibility of major sections - verbally identify areas of high complexity and low value (take notes, etc)
• Discuss overall layout approach - full width grid, mobile needs, animation concepts
• Deliverable: Style guide (At this stage, the style guide should be roughly complete. Note, style guide requirements are found below.)
• Determine all necessary ancillary views during this meeting. (This should be a working list of views that have not been explicitly designed yet, but that the content structure calls for.)
• Surface any other questions and concerns on both sides of the table

D+D Handoff Meeting Checklist

• All design assets in full form (not JPG, for example)
• Exported photos at full resolution with a reasonable naming structure
• SVG assets
• Links to font icons
• Accompanying type sheet with all font sizes (This should have been delivered with original style guide, but if it has changed, it should be delivered now)
• Any animations, videos, or other assets that aren't explicit in the design
• Accompanying design document explaining anything else that may not be clear, answering any questions that were raised in the Pre-handoff meeting.

D+D Post-Handoff Meeting Checklist

*This meeting occurs at the 50% or later mark during development.)

• Basic check-in
• Determine if type structure is adequate
• ... to-do

D+D Mid-dev Informal Meetings

• To-do

D+D Pre-Launch Meeting

• To-do

Style Guide