Merge pull request #505 from betatim/docs-fixup

Fix typos and syntax errors in the documentation

docs/source/config_files.rst

@@ -113,7 +113,7 @@ used for your R installation.
 It is powered by the open file format `Dar <https://github.com/substance/dar>`_.
 
 If your repository contains a Stencila document, repo2docker detects it based on the file ``manifest.xml``.
-The required `execution contexts <https://stenci.la/learn/intro.html>` are extracted from a Dar article (i.e.
+The required `execution contexts <https://stenci.la/learn/intro.html>`_ are extracted from a Dar article (i.e.
 files named ``*.jats.xml``).
 
 You may also have a ``runtime.txt`` and/or an ``install.R`` to manually configure your R installation.
@@ -141,9 +141,9 @@ their demo for binder <https://github.com/jupyterlab/jupyterlab-demo/blob/master
 ====================================================
 
 A script that can contain simple commands to be run at runtime (as an
-`ENTRYPOINT <https://docs.docker.com/engine/reference/builder/#entrypoint>`
+`ENTRYPOINT <https://docs.docker.com/engine/reference/builder/#entrypoint>`_
 to the docker container). If you want this to be a shell script, make sure the
-first line is ```#!/bin/bash``. The last line must be ```exec "$@"```
+first line is ``#!/bin/bash``. The last line must be ``exec "$@"``
 equivalent.
 
 Use this to set environment variables that software installed in your container

docs/source/contributing/contributing.md

@@ -18,8 +18,8 @@ repo2docker merged.
 
 ## Guidelines to getting a Pull Request merged
 
-These are not hard rules to be enforced by :police_car: but instead guidelines
-to help you make the most effictive / efficient contribution.
+These are not hard rules to be enforced by 🚓 but instead guidelines
+to help you make a contribution.
 
 * prefix the title of your pull request with `[MRG]` if the contribution
   is complete and should be subjected to a detailed review;
@@ -31,6 +31,7 @@ to help you make the most effictive / efficient contribution.
 * describe why you are proposing the changes you are proposing;
 * try to not rush changes (the definition of rush depends on how big your
   changes are);
+* Enter your changes into the [change log](https://github.com/jupyter/repo2docker/blob/master/CHANGES.rst);
 * someone else has to merge your PR;
 * new code needs to come with a test;
 * apply [PEP8](https://www.python.org/dev/peps/pep-0008/) as much
@@ -129,7 +130,3 @@ Server:
 ```
 
 Then you are good to go!
-
-
-
-