Projects WebsiteOne

WebsiteOne

A website for Agile Ventures - a platform for online collaboration and crowdsourced project development. Chat in https://agileventures.slack.com/messages/websiteone


Build Status Maintainability Test Coverage

AgileVentures WebSiteOne

This Ruby on Rails app powers the AgileVentures main developer site, showing lists of active projects, members, upcoming events, past event recordings, as well as all the machinery for Premium membership payments.

Installation

See the Project Setup documentation

Usage

🚧 UNDER CONSTRUCTION 🚧

See the site How To documentation

Contributing

See our Contribution guidelines

History

in 2011, inspired by Dave Patterson and Armando Fox's UCBerkeley Software Engineering Massive Open Online Class (MOOC), Sam Joseph had the idea for a global online pairing community where everyone worked together to use the agile development methodology to deliver solutions to IT charities and non-profits. Thomas Ochman joined as project manager and led the development of the WebSiteOne codebase with Bryan Yap serving as technical lead. Initialy Sam was the notional "client", not getting involved in the tech development, and many different volunteers contributed code. During this phase the events, projects and user systems were developed. There was also a blog like articles system. Yaro Appletov led a tight integration with Google hangouts to allow recordable hangouts to be launched from the site and report back telemetry.

Later Raoul Diffou joined to take over as project manager as Thomas and Bryan had less and less time for the project. Sam took over the technical lead role in 2016 and also stared pairing with Raoul as project manager. Later in 2016 as Raoul had less and less time Sam became the sole project manager. During the course of 2016 Sam and long time AV contributor Michael revised the events framework, and replaced the articles system with a Premium payments framework intended to help ensure AV was sustainable into the future. In 2017 Google withdrew their Hangouts API breaking various functionality in the site. Sam and Lokesh Sharma replaced the API integration with manual updates, and Sam pulled in the agile-bot node microservice so that WSO now communicates directly with Slack to alert members about new online meetings and their recordings.

Approaches

  • Agile Development
    • We try to work from user stories in regular sprints, offer daily standups, and get regular feedback from end users. We try to reflect regularly on our process and experiment with incremental changes to how we get things done.
  • Behaviour Driven Development (BDD)
    • We use Cucumber and RSpec testing tools that describe the behaviours of the system and its units
    • We try to work outside in, starting with acceptance tests, dropping to integration tests, then unit tests and then writing application code
    • We do spike application code occasionally to work out what's going on, but then either throw away the spike, or make sure all our tests break before wrapping the application code in tests (by strategically or globally breaking things)
    • Where possible we go for declarative over imperative scenarios in our acceptance tests, trying to boil down the high level features to be easily comprehensible in terms of user intention
  • Domain Driven Design (DDD)
    • Sometimes we switch to inside out, trying to adjust the underlying entity schema to better represent the domain model
  • Self-documenting code
    • We prefer executable documentation (tests) and relatively short methods where the method and variable names effectively document the code

Reading material

Walkthroughs

  • An example of a simple interface change
    • Here is the original user story
    • Here is the original cucumber scenario
    • We did not write a spec, as this would have involved a view spec which we don't feel add any value
    • Here's the code that implemented the feature

🚧 UNDER CONSTRUCTION 🚧

  • An example of a new feature involving a database change ...
  • An example of a bug fix ...

Related documents

Rails 6 TDD Pairing - The Early Birds - Tuesday, 24th Mar at 01:12pm (UTC)


Latest Project videos

Video Host Published
video unavailable ('Start Broadcast' not pressed, or Hangout/YouTube fail) Mike Aono 13:13 24/03
video unavailable ('Start Broadcast' not pressed, or Hangout/YouTube fail) Mike Aono 16:04 10/03
video unavailable ('Start Broadcast' not pressed, or Hangout/YouTube fail) Mike Aono 15:39 03/03
video unavailable ('Start Broadcast' not pressed, or Hangout/YouTube fail) Mike Aono 15:40 18/02
video unavailable ('Start Broadcast' not pressed, or Hangout/YouTube fail) Mike Aono 15:02 11/02
video unavailable ('Start Broadcast' not pressed, or Hangout/YouTube fail) Mike Aono 15:28 04/02
video unavailable ('Start Broadcast' not pressed, or Hangout/YouTube fail) Mike Aono 15:24 28/01
Rails TDD pairing session - Wednesday, 22nd Jan at 03:11pm (UTC) Mike Aono 16:47 22/01
video unavailable ('Start Broadcast' not pressed, or Hangout/YouTube fail) Mike Aono 15:12 22/01
Rails 5 TDD Mob - Tuesday, 21st Jan at 04:00pm (UTC) Mike Aono 16:35 21/01
video unavailable ('Start Broadcast' not pressed, or Hangout/YouTube fail) Mike Aono 15:10 21/01
Rails 5 TDD Pairing - Thursday, 16th Jan at 03:17pm (UTC) Mike Aono 15:21 16/01
Rails 5 TDD Mob - Tuesday, 14th Jan at 04:00pm (UTC) Mike Aono 15:10 14/01
Rails 5 TDD Mob - Tuesday, 7th Jan at 04:00pm (UTC) Mike Aono 17:40 07/01
video unavailable ('Start Broadcast' not pressed, or Hangout/YouTube fail) Mike Aono 16:04 07/01
video unavailable ('Start Broadcast' not pressed, or Hangout/YouTube fail) Mike Aono 16:05 24/12
video unavailable ('Start Broadcast' not pressed, or Hangout/YouTube fail) Mike Aono 15:51 23/12
video unavailable ('Start Broadcast' not pressed, or Hangout/YouTube fail) Mike Aono 15:32 17/12
video unavailable ('Start Broadcast' not pressed, or Hangout/YouTube fail) poppa_nick 16:38 14/12
Rails 5 TDD Mob - Tuesday, 10th Dec at 03:00pm (UTC) Mike Aono 16:47 10/12
video unavailable ('Start Broadcast' not pressed, or Hangout/YouTube fail) Mike Aono 15:25 10/12
Rails 5 TDD Mob - Tuesday, 3rd Dec at 03:00pm (UTC) Mike Aono 17:47 03/12
video unavailable ('Start Broadcast' not pressed, or Hangout/YouTube fail) Mike Aono 16:09 03/12
Rails 5 TDD Mob - Tuesday, 26th Nov at 03:00pm (UTC) Mike Aono 16:55 26/11
video unavailable ('Start Broadcast' not pressed, or Hangout/YouTube fail) Mike Aono 15:44 26/11

Stories are not supported for issue tracker type used by project WebsiteOne