Skip to content

Commit

Permalink
DOC: Add a contributing guide
Browse files Browse the repository at this point in the history
the contributing guide include documentation on how to setup the
developer environment. The README has also been updated and it
includes a link to the CONTRIBUTING guide now
  • Loading branch information
rahulporuri committed Oct 29, 2024
1 parent a770b76 commit 950e6f9
Show file tree
Hide file tree
Showing 2 changed files with 33 additions and 4 deletions.
22 changes: 22 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Contributing

## Setting up the developer environment

* Ballot is built using the [frappe framework](https://frappeframework.com/docs/user/en/basics)
and a basic understanding of it is necessary to contribute to the codebase
* [Install and setup frappe-bench](https://frappeframework.com/docs/user/en/tutorial/install-and-setup-bench).
We recommend using [pipx](https://github.com/pypa/pipx) to install
`frappe-bench` and updating the `PATH` variable to include the `.../bin/`
folder inside the `pipx`-created Python virtual environment for `frappe-bench`
* Create a new bench with `bench init ballot`. We recommend storing benches
in a single location e.g. `~/frappe-benches`
* CD into the bench directory i.e. `ballot` and clone the Ballot app using
`bench get-app https://github.com/harshtandiya/ballot`. This will clone the
Git repository into the `apps/` folder in the bench directory
* Create a [new site](https://frappeframework.com/docs/user/en/tutorial/create-a-site)
using `bench new-site test.ballot`
* Install the Ballot app on the new site `bench --site test.ballot install-app fossunited`
* [Access the site conveniently](https://frappeframework.com/docs/user/en/tutorial/create-a-site#access-site-in-your-browser)
from your computer using `bench --site test.ballot add-to-hosts`
* Finally, run `bench start` and access the site in your browser by navigating
to `http://test.ballot:<port number>`
15 changes: 11 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,14 @@
## Ballot
# Ballot

E-Voting system based on Frappe
Ballot enables communities to organize elections.

#### License
Built using the Frappe Framework for the FOSS United Platform, Ballot enables
communities to seek candidatures from interested members of the community via
customizable forms. Ballot also enables members of the community to endorse
submissions. In the future, Ballot will also be integrated with a voting
platform where the community can cast votes.

mit
## Contributions

Please refer to the [contribution guide](./CONTRIBUTING.md) if you are
interested in contributing to the codebase.

0 comments on commit 950e6f9

Please sign in to comment.