Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.
You can contribute in many ways:
Types of Contributions¶ Report Bugs¶Report bugs on Github issues.
If you are reporting a bug, please follow the guidelines shown to you while reporting the bug
Fix Bugs and Support Others¶Look through the open GitHub issues. Anything tagged with “help wanted” is open to whoever wants to implement it. Anything tagged with “support” means someone needs help, and you may be the person to help them!
Implement Features¶Look through the GitHub issues for features. Anything tagged with “enhancement” and “help wanted” is open to whoever wants to implement it.
Write Documentation¶Markdown Subscript could always use more documentation, whether as part of the official Markdown Subscript docs, in docstrings, or even on the web in blog posts, articles, and such.
Submit Feedback¶The best way to send feedback is to file an issue on Github.
If you are proposing a feature:
Ready to contribute? Here’s how to set up markdown_subscript_extension for local development.
markdown_subscript_extension repository on GitHub.Create a directory for your project, and then create a virtual environment. If you new to virtual environments, RealPython’s Virtualenv Primer is for you! The code below demonstrates how to create a virtual project with Virtualenvwrapper
$ mkproject markdown_subscript_extension
Clone your fork locally into your new project.
$ git clone git@github.com:YOUR_USERNAME_HERE/markdown_subscript_extension.git .
Install the necessary dependencies using pip. If you don’t have pip installed, the Python installation guide can guide you through the process.
$ pip install -r requirements/dev_requirements.txt $ pip install -r requirements/lint_requirements.txt $ pip install -r requirements/test_requirements.txt $ python setup.py develop
Create a branch for local development and begin to make changes!
$ git checkout -b name-of-your-bugfix-or-feature
Make small, targeted changes. Commit often, and write clear messages! Remember that this is a volunteer-drive project. The clearer your intent and your changes, the easier it will be for us to review your work.
$ git add . $ git commit -m "Your detailed description of your changes."
The project is configured to use pre-commit. If you’d like to have each commit checked as you make it, install it as a hook for your repository, as demonstrated below.
When you’re done making changes, check that your changes pass the test suite. If you’re not using pre-commit, you will also need to use the linters and auto-formatters.
$ make test # or python setup.py test $ # linters below $ flake8 mdx_subscript.py tests $ isort --verbose --check-only --diff mdx_subscript.py $ black mdx_subscript.py tests
If you have Python 2.7, 3.4, 3.5, 3.6, and 3.7 installed, as well as both PyPy and PyPy3, you may use tox to run all of the tests in all of the supported environments.
Once you’ve made the changes you want, push your branch to GitHub.
$ git push -u origin name-of-your-bugfix-or-feature
Submit a pull request from your new branch to the original repository through the GitHub website.
🎉 Thank you for taking the time to read this and for your potential contributions!
Before you submit a pull request, check that it meets these guidelines:
tox locally, the CI will run the test suite for you (but please consider running the suite beforehand).RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4