|
Note
I will be using examples from my project River Charts for this README
.
- The description should be a short paragraph describing what your project is and what it does.
- This should be the first section after the badges.
- e.g. "A Python, Django, Plotly, and Pandas web application that visualizes river data pulled using an API from the United States Geological Survey (USGS)."
- Add screenshots of your project below the description and throughout the rest of the README as needed.
- This is optional, but highly recommended especially for Gold projects.
- Animations in the form of GIFs are also a great way to showcase your project.
This section should contain a list of steps to get your project up and running.
- You can break this section down into further subsections if you want (such as below: Dependencies, Configuration, Running Locally, Deployment, etc.).
- Otherwise, you can just include a list of steps to get your project up and running under Getting Started.
- This section should contain a list of dependencies for your project.
- This section should contain a list of steps to configure your project.
- This section should contain a list of steps to install your project.
- Utilize code blocks to show the commands needed to run your project.
- e.g.
- Clone this repository.
- Create a virtual environment:
python -m venv venv
. - Install the dependencies.
- Run the application:
python manage.py runserver
- This section should contain a list of steps to deploy your project.
There should be a number of sections here that correspond to important aspects of your project.
- Do not name this section "Specific Project Sections".
- e.g. "API", "Database", "Deployment", "Testing", etc.
This section should contain a list of resources that you used to create your project.
Below are some external resources I found helpful when creating My Project:
- Python - An interpreted, high-level and general-purpose programming language.
- Plotly - A Python graphing library that makes interactive, publication-quality graphs online.
- Django - A high-level Python Web framework that encourages rapid development and clean, pragmatic design.
- Pandas - A fast, powerful, flexible and easy to use open source data analysis and manipulation tool, built on top of the Python programming language.
This section should contain the license for your project.
This project is released under the terms of the MIT License, which permits use, modification, and distribution of the code, subject to the conditions outlined in the license.
- The MIT License provides certain freedoms while preserving rights of attribution to the original creators.
- For more details, see the LICENSE file in this repository. in this repository.
Author: Scott Grivner
Email: [email protected]
Website: scottgrivner.dev
Reference: Main Branch