Merge pull request #67 from minrk/nbformat-42-notes

add notes for 4.2

docs/changelog.rst

@@ -4,9 +4,26 @@
 Changes in nbformat
 =========================
 
+4.2
+===
+
+
+4.2.0
+-----
+
+`4.2 on GitHub <https://github.com/jupyter/nbformat/milestones/4.2>`__
+
+- Update nbformat spec version to 4.2, allowing JSON outputs to have any JSONable type,  not just ``object``,
+  and mime-types of the form ``application/anything+json``.
+- Define basics of ``authors`` in notebook metadata.
+  ``nb.metadata.authors`` shall be a list of objects with the property ``name``, a string of each author's full name.
+- Update use of traitlets API to require traitlets 4.1.
+
+
 4.1
 ===
 
+
 4.1.0
 -----
 

docs/format_description.rst

@@ -312,10 +312,10 @@ keyed by filename that represents the files attached to the cell.
     {
       "cell_type" : "markdown",
       "metadata" : {},
-      "source" : ["Here is an *inline* image ![inline image](attachment:test.png)"],
+      "source" : ["Here is an *inline* image ![inline image](attachment://test.png)"],
       "attachments" : {
         "test.png": {
-            "image/png" : ["base64-encoded-png-data"]
+            "image/png" : "base64-encoded-png-data"
         }
       }
     }
@@ -356,8 +356,23 @@ The following metadata keys are defined at the notebook level:
 Key         Value           Interpretation
 =========== =============== ==============
 kernelspec  dict            A :ref:`kernel specification <kernelspecs>`
+authors     list of dicts   A list of authors of the document
 =========== =============== ==============
 
+A notebook's authors is a list of dictionaries containing information about each author of the notebook.
+Currently, only the name is required.
+Additional fields may be added.
+
+.. sourcecode:: python
+
+    nb.metadata.authors = [
+        {
+            'name': 'Fernando Perez',
+        },
+        {
+            'name': 'Brian Granger',
+        },
+    ]
 
 Cell metadata
 -------------