mirror of
https://github.com/mkdocs/mkdocs.git
synced 2026-03-27 09:58:31 +07:00
Added an initial Contributing guide
This commit is contained in:
6
CONTRIBUTING.md
Normal file
6
CONTRIBUTING.md
Normal file
@@ -0,0 +1,6 @@
|
||||
# Contributing to MkDocs
|
||||
|
||||
See the contributing guide in the documentation for an
|
||||
introduction to contributing to MkDocs.
|
||||
|
||||
http://www.mkdocs.org/about/contributing
|
||||
48
docs/about/contributing.md
Normal file
48
docs/about/contributing.md
Normal file
@@ -0,0 +1,48 @@
|
||||
# Contributing to MkDocs
|
||||
|
||||
An introduction to contributing to the MkDocs project.
|
||||
|
||||
The MkDocs project welcomes, and depends, on contributions from
|
||||
developers and users in the open source community. Contributions
|
||||
can be made in a number of ways, a few examples are:
|
||||
|
||||
- Code patches via pull requests
|
||||
- Documentation improvements
|
||||
- Bug reports and patch reviews
|
||||
|
||||
## Installing for development
|
||||
|
||||
First you'll need to fork and clone the repository. Once you have
|
||||
a local copy, run the following command. It is recommended that
|
||||
you do this within a [virtualenv](virtualenv).
|
||||
|
||||
```no-highlight
|
||||
pip install --editable .
|
||||
```
|
||||
|
||||
This will install MkDocs in development mode which binds the
|
||||
`mkdocs` command to the git repository.
|
||||
|
||||
|
||||
## Running the tests
|
||||
|
||||
To run the tests, it is recommended that you use [Tox](tox). This
|
||||
just needs to be pip installed and then the test suite can be ran
|
||||
for MkDocs but running the command `tox` in the root of your
|
||||
MkDocs repository.
|
||||
|
||||
It will attempt to run the tests against all of the Python
|
||||
versions we support. So don't be concerned if you are missing
|
||||
some and they fail. The rest will be verified by [Travis](travis)
|
||||
when you submit a pull request.
|
||||
|
||||
## Submitting Pull Requests
|
||||
|
||||
Once you are happy with your changes or you are ready for some
|
||||
feedback, push it to your fork and send a pull request. For a
|
||||
change to be accepted it will most likely need to have tests and
|
||||
documentation if it is a new feature.
|
||||
|
||||
[virtualenv]: https://virtualenv.pypa.io/en/latest/userguide.html
|
||||
[tox]: https://tox.readthedocs.org/en/latest/
|
||||
[travis]: https://travis-ci.org/repositories
|
||||
@@ -11,6 +11,7 @@ pages:
|
||||
- ['user-guide/configuration.md', 'User Guide', 'Configuration']
|
||||
- ['about/license.md', 'About', 'License']
|
||||
- ['about/release-notes.md', 'About', 'Release Notes']
|
||||
- ['about/contributing.md', 'About', 'Contributing']
|
||||
|
||||
copyright: Copyright © 2014, <a href="https://twitter.com/_tomchristie">Tom Christie</a>.
|
||||
google_analytics: ['UA-27795084-5', 'mkdocs.org']
|
||||
|
||||
Reference in New Issue
Block a user