address doc review feedback

Author: willingc

CHANGELOG.md

@@ -6,11 +6,11 @@
 
 ### Significant changes
 
-Validation information is now exposed as a dict at the /api/bookstore endpoint.
+Validation information is now exposed as a dict at the `/api/bookstore` endpoint.
 
 This allows us to distinguish whether different features have been enabled on bookstore.
 
-The structure now is 
+The structure for 2.3.0 is:
 
 ```python
     validation_checks = {
@@ -19,6 +19,7 @@ The structure now is
         "publish_valid": all(published_settings),
     }
 ```
+
 ## Releases prior to 2.3.0
 
 [2.2.1 (2019-02-03)](https://github.com/nteract/bookstore/releases/tag/2.2.1)

CONTRIBUTING.md

@@ -61,7 +61,7 @@ Good commit messages serve at least three important purposes:
 
 Structure your commit message like this:
 
-```
+```text
 > Short (50 chars or less) summary of changes
 >
 > More detailed explanatory text, if necessary.  Wrap it to about 72
@@ -79,7 +79,8 @@ Structure your commit message like this:
 >     single space, with blank lines in between, but conventions vary here
 >
 ```
-*Source: http://git-scm.com/book/ch5-2.html*
+
+*Source:* https://git-scm.com/book/ch5-2.html
 
 ### DO
 

running_ci_locally.md

@@ -23,10 +23,9 @@ To run the ci tests locally, you will need to have a few things set up:
 1. Open two terminals with the current working directory as the root `bookstore`
    directory.
 
-2. In one terminal run `ci/local.sh`. This will start up minio.
+2. In one terminal run `yarn test:server`. This will start up minio.
 
-3. In the other terminal run `node ci/integration.js`. This will run the
-   integration tests
+3. In the other terminal run `yarn test`. This will run the integration tests.
 
 ## Interactive python tests
 
@@ -43,7 +42,7 @@ It's often difficult to judge whether what is being served makes sense from a UI
 without being able to investigate it directly. At the same time we'll need to access it as an
 API to ensure that the responses are well-behaved from an API standpoint. By using python to
 query a live server and a browser to visit the landing page, we can rapidly iterate between
-the API and UI contexts from the same live server's endpoint. 
+the API and UI contexts from the same live server's endpoint.
 
 We provide examples of `jupyter notebook` commands needed in that file as well for both
 accessing the `nteract-notebooks` S3 bucket as well as the Minio provided `bookstore` bucket