Repository: Qiskit/qiskit

Issue:
Finalize changelog for 0.6 release
<!-- ⚠️ If you do not respect this template, your issue will be closed -->
<!-- ⚠️ Make sure to browse the opened and closed issues to confirm this idea does not exist. -->

### What is the expected enhancement?





Discussion:
@diego-plan9 can you list all the things we need to do here. 
Sure - once #965 is in place, there should be not much left to be done, and they would be quite straightforward:
* go through the sphinx docs, making sure the examples are updated based on the ones in the README
* run `make doc` to check that no warnings are raised (malformed docstrings, etc), to ensure the uploaded documentation looks as expected
* routine changes on the changelog file (rename section, add link, create new empty section)

I can take care of them just before the release indeed - hopefully making this PR the very last one for 0.6

Resolving patch:
diff --git a/qiskit/_schema_validation.py b/qiskit/_schema_validation.py
--- a/qiskit/_schema_validation.py
+++ b/qiskit/_schema_validation.py
@@ -32,16 +32,16 @@
 
 
 def _load_schema(file_path, name=None):
-    """Loads the QObj schema for use in future validations. Caches schema in
-       _SCHEMAS module attribute.
-       Args:
-            file_path(str): Path to schema.
-            name(str): Given name for schema. Defaults to file_path filename
-                       without schema.
-       Return:
-            schema(dict): Loaded schema.
+    """Loads the QObj schema for use in future validations.
 
+    Caches schema in _SCHEMAS module attribute.
 
+   Args:
+        file_path(str): Path to schema.
+        name(str): Given name for schema. Defaults to file_path filename
+            without schema.
+   Return:
+        schema(dict): Loaded schema.
     """
     if name is None:
         # filename without extension
@@ -60,16 +60,14 @@ def _get_validator(name, schema=None, check_schema=True,
 
     Args:
         name (str): Name for validator. Will be validator key in
-                    `_VALIDATORS` dict.
+            `_VALIDATORS` dict.
         schema (dict): JSON schema `dict`. If not provided searches for schema
-                       in `_SCHEMAS`.
+            in `_SCHEMAS`.
         check_schema (bool): Verify schema is valid.
-
-        validator_class (jsonschema.IValidator): jsonschema IValidator
-                instance. Default behavior is to determine this from the schema
-                `$schema` field.
-
-        **validator_kwargs: Additional keyword arguments for validator.
+        validator_class (jsonschema.IValidator): jsonschema IValidator instance.
+            Default behavior is to determine this from the schema `$schema`
+            field.
+        **validator_kwargs (dict): Additional keyword arguments for validator.
 
     Return:
         jsonschema.IValidator: Validator for JSON schema.
@@ -102,9 +100,7 @@ def _get_validator(name, schema=None, check_schema=True,
 
 
 def _load_schemas_and_validators():
-    """
-    Load all default schemas into `_SCHEMAS`.
-    """
+    """Load all default schemas into `_SCHEMAS`."""
 
     schema_base_path = qiskit_path[0]
     for name, path in _DEFAULT_SCHEMA_PATHS.items():
@@ -118,8 +114,7 @@ def _load_schemas_and_validators():
 
 def validate_json_against_schema(json_dict, schema,
                                  err_msg=None):
-    """
-    Validates JSON dict against a schema.
+    """Validates JSON dict against a schema.
 
     Args:
         json_dict (dict): JSON to be validated.
@@ -154,8 +149,9 @@ def validate_json_against_schema(json_dict, schema,
 
 
 def _format_causes(err, level=0):
-    """Return a cascading explanation of the validation error in the form
-    of::
+    """Return a cascading explanation of the validation error.
+
+    Returns a cascading explanation of the validation error in the form of::
 
         <validator> failed @ <subfield_path> because of:
             <validator> failed @ <subfield_path> because of:
@@ -224,7 +220,9 @@ class SchemaValidationError(QISKitError):
 
 
 class _SummaryValidationError(QISKitError):
-    """Cut off the message of a jsonschema.ValidationError to avoid printing
+    """Cut off the message of a jsonschema.ValidationError for compactness.
+
+    Cut off the message of a jsonschema.ValidationError to avoid printing
     noise in the standard output. The original validation error is in the
     `validation_error` property.
 
diff --git a/qiskit/transpiler/_parallel.py b/qiskit/transpiler/_parallel.py
--- a/qiskit/transpiler/_parallel.py
+++ b/qiskit/transpiler/_parallel.py
@@ -38,7 +38,8 @@
 #    OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 ###############################################################################
 
-"""Routines for running Python functions in parallel using process pools
+"""
+Routines for running Python functions in parallel using process pools
 from the multiprocessing library.
 """
 
@@ -59,12 +60,13 @@ def parallel_map(task, values, task_args=tuple(), task_kwargs={},  # pylint: dis
     """
     Parallel execution of a mapping of `values` to the function `task`. This
     is functionally equivalent to::
+
         result = [task(value, *task_args, **task_kwargs) for value in values]
 
     On Windows this function defaults to a serial implimentation to avoid the
     overhead from spawning processes in Windows.
 
-    Parameters:
+    Args:
         task (func): Function that is to be called for each value in ``task_vec``.
         values (array_like): List or array of values for which the ``task``
                             function is to be evaluated.
diff --git a/qiskit/wrapper/_wrapper.py b/qiskit/wrapper/_wrapper.py
--- a/qiskit/wrapper/_wrapper.py
+++ b/qiskit/wrapper/_wrapper.py
@@ -54,7 +54,7 @@ def register(*args, provider_class=None, **kwargs):
     .. deprecated:: 0.6+
         After 0.6, this function is deprecated. Please use the methods in
         `qiskit.IBMQ` instead (`enable_account()`) for using IBMQ
-        accounts. For custom `Provider`s, please instantiate them directly.
+        accounts. For custom `Providers`, please instantiate them directly.
     """
     if provider_class:
         warnings.warn(


Test patch: