An open API service indexing awesome lists of open source software.

https://github.com/openplans/shareabouts-pbcambridge

Collaborative map for the Cambridge MA participatory budgeting process
https://github.com/openplans/shareabouts-pbcambridge

Last synced: 3 months ago
JSON representation

Collaborative map for the Cambridge MA participatory budgeting process

Awesome Lists containing this project

README

          

Shareabouts [![Build Status](https://secure.travis-ci.org/openplans/shareabouts.png)](http://travis-ci.org/openplans/shareabouts) [![Deployment status from dploy.io](https://openplans.dploy.io/badge/45290641861022/15348.png)](http://dploy.io)
===========

Shareabouts is an online mapping tool to gather crowdsourced public input in a social and engaging process. Using Shareabouts, people can drop a pin on a map to provide ideas, suggestions, and comments for planning and design issues. And as a mobile-friendly application, Shareabouts makes it easy to add input on the go.

Read more about Shareabouts and find links to recent sites [on the OpenPlans website](http://openplans.org/shareabouts/).

A short guide to setting up Shareabouts
-----------

It's helpful, but not required, to know about the [architecture of Shareabouts](https://github.com/openplans/shareabouts/blob/master/doc/ARCHITECTURE.md) before starting.

The easiest way to set up Shareabouts is to use the Heroku Button.

[![Deploy](https://www.herokucdn.com/deploy/button.png)](https://heroku.com/deploy)

This will deploy a fully-functional Shareabouts map and datastore to your account on Heroku (an easy-to-manage hosting service). Hosting this way will cost $50-100 monthly. [Here's the process](https://github.com/openplans/shareabouts/blob/master/doc/HEROKU_BUTTON.md).

Alternatively, you may want to use a [different hosting service](https://github.com/openplans/shareabouts/blob/master/doc/DEPLOY.md) and set up the components of Shareabouts manually.

Documentation
-------------
All of our documentation is is our `doc` directory. Use it to learn more about:
* [the architecture](https://github.com/openplans/shareabouts/blob/master/doc/ARCHITECTURE.md)
* [local setup](https://github.com/openplans/shareabouts/blob/master/doc/README.md)
* [testing the source](https://github.com/openplans/shareabouts/blob/master/doc/TESTING.md)
* [interface configuration](https://github.com/openplans/shareabouts/blob/master/doc/CONFIG.md)
* [custom themes](https://github.com/openplans/shareabouts/blob/master/doc/CUSTOM_THEME.md)
* [deploying with the Heroku button](https://github.com/openplans/shareabouts/blob/master/doc/HEROKU_BUTTON.md) and [in other ways](https://github.com/openplans/shareabouts/blob/master/doc/DEPLOY.md)
* [upgrading from an older version](https://github.com/openplans/shareabouts/blob/master/doc/UPGRADE.md)
* [getting your data once you have a map running](https://github.com/openplans/shareabouts/blob/master/doc/GETTING_YOUR_DATA.md)

Questions? Problems? Ideas?
--------------------

The best place to ask questions or get help is [community.openplans.org](http://community.openplans.org), an open forum on Shareabouts (and some other stuff from OpenPlans). Asking questions there will help everyone else.

If you encounted a bug, [create an issue](https://github.com/openplans/shareabouts/issues) on this GitHub repo.

We have a [Trello board](https://trello.com/b/94MT3WRQ/openplans-roadmap) to collect feature suggestions, but you might get more eyeballs and responses by posting to the forum first.

Contributing
------------
In the spirit of [free software](http://www.fsf.org/licensing/essays/free-sw.html), **everyone** is encouraged to help improve this project.

Here are some ways *you* can contribute:

* by joining our developers discussion list: http://groups.google.com/group/shareabouts-dev
* by taking a look at our pipeline in the public tracker: https://www.pivotaltracker.com/projects/398973
* by using alpha, beta, and prerelease versions
* by reporting bugs
* by suggesting new features
* by writing or editing documentation
* by writing specifications
* by writing code (**no patch is too small**: fix typos, add comments, clean up inconsistent whitespace)
* by refactoring code
* by resolving issues
* by reviewing patches

Credits
-------------
Shareabouts is a project of [OpenPlans](http://openplans.org).