Add a usage section to readme

README.md

@@ -21,6 +21,19 @@ to communication around the project.
 
 The initial implementation of this package was funded by [Braintrust Data](https://braintrustdata.com/).
 
+## Usage
+
+```javascript
+import {EditorView, basicSetup} from "codemirror"
+import {yaml} from "@codemirror/lang-yaml"
+
+const view = new EditorView({
+  parent: document.body,
+  doc: `name: Ferdinand\nage: 93`,
+  extensions: [basicSetup, yaml()]
+})
+```
+
 ## API Reference
 
 <dl>
@@ -43,4 +56,4 @@ highlighting and indentation information.</p>
 with an optional YAML &quot;frontmatter&quot; delimited by lines that
 contain three dashes.</p>
 </dd>
-</dl>
+</dl>

src/README.md

@@ -21,10 +21,23 @@ to communication around the project.
 
 The initial implementation of this package was funded by [Braintrust Data](https://braintrustdata.com/).
 
+## Usage
+
+```javascript
+import {EditorView, basicSetup} from "codemirror"
+import {yaml} from "@codemirror/lang-yaml"
+
+const view = new EditorView({
+  parent: document.body,
+  doc: `name: Ferdinand\nage: 93`,
+  extensions: [basicSetup, yaml()]
+})
+```
+
 ## API Reference
 
 @yaml
 
 @yamlLanguage
 
-@yamlFrontmatter
+@yamlFrontmatter