small doc fixes

Author: orbeckst

CHANGELOG.md

@@ -4,6 +4,10 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+### Fixes
+
+
 ## [0.2.1] - 2018-10-05
 ### Added
 - documentation (#4)

docs/install.rst

@@ -4,17 +4,18 @@
  Installing
 ============
 
-The package is pure Python you easily install the `MDAnalysisData
-package`_ from the Python Package Index (PyPi) with :program:`pip`:
+The package is pure Python and one can directly install the
+`MDAnalysisData package`_ from the Python Package Index (PyPi) with
+:program:`pip`:
 
 .. code-block:: bash
 
    pip install --upgrade MDAnalysisData
 
 .. note:: The package itself is small and initially does not install
           any datasets. However, the :ref:`data directory
-          <managing-data>` where datasets are cached can grow to many
-          gigabytes.
+          <managing-data>`, where datasets are cached, can grow to
+          many gigabytes.
 
 .. _`MDAnalysisData package`:
    https://pypi.org/project/MDAnalysisData/

docs/usage.rst

@@ -28,24 +28,24 @@ As an example, we can access the :ref:`AdK equilibrium dataset
 :func:`~MDAnalysisData.adk_equilibrium.fetch_adk_equilibrium`
 function::
 
-    >>> from MDAnalysis import datasets
+    >>> from MDAnalysisData import datasets
     >>> adk = datasets.fetch_adk_equilibrium()
 
 This will download the dataset from figshare (doi:
 `10.6084/m9.figshare.5108170.v1
 <https://doi.org/10.6084/m9.figshare.5108170.v1>`_) and unpack it into
-a cache directory. This means that only the first time, executing
+a cache directory. This means that only the first time executing
 :func:`~MDAnalysisData.adk_equilibrium.fetch_adk_equilibrium` will be
-slow; at later times, the cached files will be used. The the resulting
+slow; at later times, the cached files will be used. The resulting
 :class:`~MDAnalysisData.base.Bunch` object can be introspected for
 what this dataset includes.  In particular, it features a
 :attr:`~MDAnalysisData.base.Bunch.DESCR` attribute with a
 human-readable description of the dataset::
 
     >>> print(adk.DESCR)
-    ====================================
-     AdK equilibrium trajectory dataset
-    ====================================
+    
+    AdK equilibrium trajectory dataset
+    ==================================
 
     MD trajectory of apo adenylate kinase with CHARMM27 force field and
     simulated with explicit water and ions in NPT at 300 K and 1
@@ -56,7 +56,6 @@ human-readable description of the dataset::
     The topology is contained in the PSF file (CHARMM format). The
     trajectory is contained in the DCD file (CHARMM/NAMD format).
 
-
     Notes
     -----