Add a note about installing the dev version

Fixes #548
This commit is contained in:
Dougal Matthews
2015-05-26 09:42:15 +01:00
parent 463c5b647e
commit f6b61d863c

View File

@@ -2,54 +2,63 @@
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:
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
## Reporting an issue?
## Reporting an Issue?
Please include as much detail as you can. Let us know your
platform and MkDocs version. If the problem is visual (for
example a theme or design issue) please add a screenshot and if
you get an error please include the the full error and traceback.
Please include as much detail as you can. Let us know your platform and MkDocs
version. If the problem is visual (for example a theme or design issue) please
add a screenshot and if you get an error please include the the full error and
traceback.
## Installing for development
## Testing the Development Version
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).
If you want to just install and try out the latest development version of
MkDocs you can do so with the following command. This can be useful if you
want to provide feedback for a new feature or want to confirm if a bug you
have encountered is fixed in the git master. It is **strongly** recommended
that you do this within a [virtualenv](virtualenv).
```text
```bash
pip install https://github.com/mkdocs/mkdocs/archive/master.tar.gz
```
## 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 **strongly** recommended that you do
this within a [virtualenv](virtualenv).
```bash
pip install --editable .
```
This will install MkDocs in development mode which binds the
`mkdocs` command to the git repository.
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.
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.
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.
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/