DOC: Centralize documentation.md

.travis.yml

@@ -19,4 +19,3 @@ script:
   - coverage report -m  # Generate test coverage report.
   - codecov  # Upload the report to codecov.
   - flake8 --max-line-length=115  # Enforce code style (but relax line length limit a bit).
-  - make -C docs html  # Build the documentation.

CHANGELOG.md

@@ -0,0 +1,9 @@
+# suitcase-mongo changes
+
+## v0.2.0 (2020-03-13)
+
+## v0.1.2 (2020-03-11)
+
+## v0.1.1 (2019-10-18)
+
+## v0.1.0 (2019-05-03)

README.md

@@ -15,3 +15,32 @@ contains two packages:
 ```
 pip install suitcase-mongo
 ```
+
+## Quick Start
+
+`suitcase-mongo` supports `mongo_normalized` and `mongo_embedded`.
+
+Using `mongo_normalized`:
+
+```
+from suitcase.mongo_normalized import Serializer
+docs = db[-1].documents(fill=True)
+serializer = Serializer(METADATASTORE_DB, ASSET_REGISTRY_DB)
+for item in documents:
+  serializer(*item)
+```
+
+Using `mongo_embedded`:
+
+```
+from suitcase.mongo_embedded import Serializer
+
+docs = db[-1].documents(fill=True)
+serializer = Serializer(PERMANENT_DB)
+for item in docs:
+  serializer(*item)
+```
+
+## Documentation
+
+See the [suitcase documentation](https://nsls-ii.github.io/suitcase).

requirements-dev.txt

@@ -5,13 +5,6 @@ codecov
 coverage
 flake8
 pytest >=3.9
-sphinx
 suitcase-utils[test_fixtures] >=0.1.0rc2
-# These are dependencies of various sphinx extensions for documentation.
-ipython
-matplotlib
-numpydoc
-sphinx-copybutton
-sphinx_rtd_theme
 # TEMPORARY UNTIL https://github.com/NSLS-II/ophyd/pull/682 IS RELEASED
 git+git://github.com/NSLS-II/ophyd@ophyd-for-suitcase-utils