diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index c935d5a3..c7f581a1 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -29,7 +29,10 @@ Style Guide
-----------
MongoEngine aims to follow `PEP8 `_
-including 4 space indents and 79 character line limits.
+including 4 space indents. When possible we try to stick to 79 character line limits.
+However, screens got bigger and an ORM has a strong focus on readability and
+if it can help, we accept 119 as maximum line length, in a similar way as
+`django does `_
Testing
-------
@@ -38,6 +41,10 @@ All tests are run on `Travis `_
and any pull requests are automatically tested by Travis. Any pull requests
without tests will take longer to be integrated and might be refused.
+You may also submit a simple failing test as a PullRequest if you don't know
+how to fix it, it will be easier for other peopl to work on it and it may get
+fixed faster.
+
General Guidelines
------------------
@@ -48,6 +55,7 @@ General Guidelines
from the cmd line to run the test suite).
- Ensure tests pass on every Python and PyMongo versions.
You can test on these versions locally by executing ``tox``
+- Add enhancements or problematic bug fixes to docs/changelog.rst
- Add yourself to AUTHORS :)
Documentation
diff --git a/README.rst b/README.rst
index f2829cd3..f4c92d5f 100644
--- a/README.rst
+++ b/README.rst
@@ -26,7 +26,9 @@ a `tutorial `_
+We recommend the use of `virtualenv `_ and of
+`pip `_. You can then use ``pip install -U mongoengine``.
+You may also have `setuptools `_ and thus
you can use ``easy_install -U mongoengine``. Otherwise, you can download the
source from `GitHub `_ and run ``python
setup.py install``.
@@ -114,7 +116,7 @@ Also use the -s argument if you want to print out whatever or access pdb while t
.. code-block:: shell
- $ python setup.py nosetests --tests tests/test_django.py:QuerySetTest.test_get_document_or_404 -s
+ $ python setup.py nosetests --tests tests/fields/fields.py:FieldTest.test_cls_field -s
Community
=========
diff --git a/docs/django.rst b/docs/django.rst
index 6982fe64..b8a52165 100644
--- a/docs/django.rst
+++ b/docs/django.rst
@@ -15,5 +15,5 @@ The MongoEngine team is looking for help contributing and maintaining a new
Django extension for MongoEngine! If you have Django experience and would like
to help contribute to the project, please get in touch on the
`mailing list `_ or by
-simpily contributing on
+simply contributing on
`GitHub `_.