Skip to content

Latest commit

 

History

History
62 lines (40 loc) · 2.75 KB

readme.md

File metadata and controls

62 lines (40 loc) · 2.75 KB

Madison

Build Status Scrutinizer Code Quality

Madison is an open-source, collaborative document editing platform. While Madison can be used to collaborate on many different kinds of documents, the official version is being built with legislative and policy documents in mind.

If you have questions about Madison, please open an issue and we will try to respond as soon as possible.

Check out the Madison Documentation or jump right into the Issue Log for more information on the project.

We have created a new, public mailing list for Madison development in Google Groups that you might be interested in subscribing to. We'll be using this as the official channel for all Madison developer news, announcements, and chat from now on. (Though bugs should still be reported here on Github.) You can sign up for it here:

Madison Mailing List

We have also created a very short survey to find out more about the developers using Madison. Please take a few minutes to fill out this survey so we can better understand what your needs are and who is using Madison:

Madison Developers Survey

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.