The Madison platform allows public collaboration on draft documents such as legislation and policies! This codebase is a project of the OpenGov Foundation, the OCTO Technology Innovation Program and DC Council.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app
bootstrap
config
database
docs
public
resources
storage
tasks
tests
.bowerrc
.editorconfig
.env.example
.gitattributes
.gitignore
.jscsrc
.jshintrc
.scrutinizer.yml
.styleci.yml
.travis.yml
CONTRIBUTING.md
Gruntfile.js
INSTALL.OSX.md
LICENSE.md
LICENSE.txt
VagrantConfig.example.json
Vagrantfile
artisan
aws_bootstrap.sh
bower.json
civic.json
composer.json
composer.lock
config.rb
gulpfile.js
install.md
karma.conf.js
package.json
phpspec.yml
phpunit.xml
project.md
protractor.conf.js
puppet_bootstrap.sh
readme.md
server.php

readme.md

Madison

Build Status

Madison is the open-source, collaborative document editing platform that powers drafts.dc.gov.

The site is in beta, so if you run into any problems or have questions, please open an issue and we will try to respond as soon as possible.

We have forked the Madison master repository, which remains in active development. You are encouraged to submit (non-DC specific) issues and pull requests there instead.

Installation

Please take a look at the Madison Documentation for how to install Madison.

Testing Suite

To run the automated test suite locally you will first need to use the webdriver manager provided by protractor. This allows you to install and run selenium through a simple cli.

$ npm install -g protractor
$ webdriver-manager update

To start the selenium server:

$ webdriver-manager start

Once that is installed, you should be able to run tests for various browsers using grunt test_{browser name} like so:

$ grunt test_chrome
$ grunt test_firefox
$ grunt test_ie

A database is automatically created in mysql for testing, so no need to create one.

You will need to have drivers installed for these browsers to test them locally. When a pull request is created, the tests will be run for all browsers using Sauce Labs.

How to help

  • Open an issue, claim an issue, comment on an issue, or submit a pull request to resolve one
  • Document Madison - wiki documentation, installation guide, or docblocks internally
  • Clean up existing code - I'm sure we've taken shortcuts or added lazy code somewhere.