Contributing¶
Before contributing, we highly recommend introducing yourself and your ideas on gitter.
Setting Up Simulate¶
- Make sure you have Flutter installed (https://flutter.dev/docs/get-started/install)
- Fork the repository
- Clone the forked repository:
git clone https://github.com/[YOUR USERNAME]/simulate.git
- Connect a device or run an emulator (Make sure your connected device has USB Debugging enabled)
- Navigate to the project directory and Run:
cd simulate flutter run
Building your stuff¶
Fixing a bug:¶
- Open an issue or report on gitter
- Make a new branch
git checkout -b [BRANCH NAME]
- Fix the bug, push and open a pull request
Adding a new Simulation:¶
- Got an idea? Discuss the idea on gitter or just open an issue with this template. If the maintainers find it interesting, the issue will be labeled accepted. If you want to work on it and don't know how to implement it yet, we'll help you get it done.
- Even if you don't have an idea but are interested in working on one, checkout the accepted simulation ideas and get assigned.
- You can start working now! Make sure you ask for help when needed, it's okay to get stuck.
Setting Up Docs¶
- Install mkdocs and its requirements
python3 -m pip install -r requirements-docs.txt
-
Check the installations by:
mkdocs --version
If this doesn't work, try restarting the terminal
-
Use the below command to host the documentation on local server
MkDocs supports live reload so you don't have to run the server again and again. Just make your changes in the docs and you'll see the change immediately.mkdocs serve --dev-addr 127.0.0.1:8000
- All the documentation is present in the
docs
directory.
Don't hesitate in asking questions, it's a part of learning and everyone is here to help.
Last update:
February 1, 2022