docs(Extensions): Update extension docs

src/extensions/cite-apa/README.md

@@ -1,3 +1,3 @@
-# APA citation style plugin
+# APA citation style extension
 
 Provides styling for in-text citations and bibliographies in accordance with the [American Psychological Association (APA) style](https://en.wikipedia.org/wiki/APA_style).

src/extensions/cite-mla/README.md

@@ -1,3 +1,3 @@
-# MLA citation style plugin
+# MLA citation style extension
 
 Provides styling for in-text citations and bibliographies in accordance with the [Modern Language Association (MLA) style](https://style.mla.org/).

src/extensions/cite/README.md

@@ -1,3 +1,5 @@
-# Citation plugin
+# Citation extension
 
 Provides styling for in-text citations (i.e. `Cite` and `CiteGroup` nodes) and bibliographies (i.e. `CreativeWork` nodes in the `references` property of another `CreativeWork`).
+
+This extension acts as a base for other extensions e.g. `cite-apa` that provide styling for a particular citation style.

src/extensions/code/README.md

@@ -1,6 +1,6 @@
-# `CodeFragment` and `CodeBlock` pseudo-components
+# Code nodes extension
 
-Syntax highlighting for `CodeFragment` and `CodeBlock` nodes using [Prism](https://prismjs.com/). Will also style executable node types like `CodeExpression` and `CodeChunk` if you do not use the `default` components.
+Provides syntax highlighting for `CodeFragment` and `CodeBlock` nodes using [Prism](https://prismjs.com/). Will not style executable node types like `CodeExpression` and `CodeChunk` which are styled by the base Stencila Web Components.
 
 ## Notes
 

src/extensions/math/README.md

@@ -1,4 +1,4 @@
-# `MathFragment` and `MathBlock` pseudo-components
+# Math styling extension.
 
 Provides styling of math nodes using MathJax fonts and styles. Use this if there is any likely to be math content, i.e. `MathFragment` and/or `MathBlock` nodes, in documents that your theme targets.
 

src/extensions/person/README.md

@@ -1 +1,3 @@
-# Person component
+# Person extension
+
+Provides styling of `Person` nodes e.g the `authors` of an article, or authors for each `citation` in it's `references`.

src/extensions/person/index.ts

@@ -28,6 +28,8 @@ import { after, create, replace, select, ready } from '../../scripts/dom'
  * ```
  */
 ready(() => {
+  // This is a proposal, but due to conflicts with existing styles, is currently
+  // not enabled.
   return
   select('[itemtype="http://schema.org/Person"] span[itemprop=name]').forEach(
     span => {