update docs

README.md

@@ -28,26 +28,26 @@ import mdocfile
 df = mdocfile.read('my_mdoc_file.mdoc')
 ```
 
-`Mdoc.from_string().as_dataframe()` will return the contents of string mdoc data as a pandas dataframe. 
-This is useful for mdoc data that is not stored in a file (e.g. from a database or a web request). 
-
-```python
-from mdocfile.data_models import Mdoc
-
-mdoc_data = ...
-
-mdoc = Mdoc.from_string(mdoc_data).as_dataframe()
-```
-
 For writing valid mdoc files, please see 
 [writing mdoc files](https://teamtomo.org/mdocfile/writing/).
 
-
-
 # Installation
 
 pip:
 
 ```shell
 pip install mdocfile
 ```
+
+# Parsing from text
+
+`Mdoc.from_string().as_dataframe()` will return the contents of string mdoc data as a pandas dataframe. 
+This is useful for mdoc data that is not stored in a file (e.g. from a database or a web request). 
+
+```python
+from mdocfile.data_models import Mdoc
+
+mdoc_data = ...
+
+mdoc = Mdoc.from_string(mdoc_data).as_dataframe()
+```

docs/index.md

@@ -29,17 +29,6 @@ import mdocfile
 df = mdocfile.read('my_mdoc_file.mdoc')
 ```
 
-`Mdoc.from_string().as_dataframe()` will return the contents of string mdoc data as a pandas dataframe. 
-This is useful for mdoc data that is not stored in a file (e.g. from a database or a web request). 
-
-```python
-from mdocfile.data_models import Mdoc
-
-mdoc_data = ...
-
-mdoc = Mdoc.from_string(mdoc_data).as_dataframe()
-```
-
 ---
 
 For writing valid mdoc files, please see [writing mdoc files](./writing.md).
@@ -50,4 +39,17 @@ pip:
 
 ```shell
 pip install mdocfile
-```
+```
+
+# Parsing from text
+
+`Mdoc.from_string().as_dataframe()` will return the contents of string mdoc data as a pandas dataframe. 
+This is useful for mdoc data that is not stored in a file (e.g. from a database or a web request). 
+
+```python
+from mdocfile.data_models import Mdoc
+
+mdoc_data = ...
+
+mdoc = Mdoc.from_string(mdoc_data).as_dataframe()
+```