docs review

Author: mmcky

docs/source/index.md

@@ -20,11 +20,11 @@ for producing exercise and solution directives, for html and pdf outputs.
 
 **Features**:
 
-The **exercise** directive is
+The **exercise** directive is:
 
 1. automatically numbered
 2. supports options such as `class`, `label`, `nonumber`, and `hidden`
-3. can easily be referenced through `ref` and `numref` roles
+3. can be referenced through `ref` and `numref` roles
 
 The **solution** directive
 
@@ -37,7 +37,7 @@ The **solution** directive
 To get started with `sphinx-exercise`, first install it through `pip`:
 
 ```bash
-pip install -e.
+pip install sphinx-exercise
 ```
 
 ### Jupyter-Book Project
@@ -50,7 +50,7 @@ sphinx:
     - sphinx_exercise
 ```
 
-you may then use `jb build <project>` and the extension will be used by your `JupyterBook` project.
+you may then use `jb build <project>` and the extension will be used by your `Jupyter Book` project.
 
 ### Sphinx Project
 

docs/source/syntax.md

@@ -62,16 +62,14 @@ You can refer to an exercise using the `{ref}` role like ```{ref}`my-exercise` `
 
 Enumerable directives can also be referenced through the `numref` role like ```{numref}`my-exercise` ```, which will display the number of the exercise directive. Referencing the above directive will display {numref}`my-exercise`. Furthermore, `numref` can take in three additional placeholders: _%s_ and _{number}_ which get replaced by the exercise number and _name_ by the exercise title.[^note]
 
-
-
-<!-- You can refer to an exercise using the `{ref}` role like: ```{ref}`my-exercise` ```, which will replace the reference with the exercise number like so: {ref}`my-exercise`. When an explicit text is provided, this caption will serve as the title of the reference. -->
-
 [^note]: If the exercise directive does not have a title, an `invalid numfig format` warning will be displayed during build if the user tries to use the _{name}_ placeholder.
 
 
 ## Solution Directive
 
-A solution directive can be included using the `solution` pattern. It takes in the label of the directive it wants to link to as a required argument. Unlike the `exercise` directive, the solution directive is unenumerable. The following options are also supported:
+A solution directive can be included using the `solution` pattern. It takes in the label of the directive it wants to link to as a required argument. Unlike the `exercise` directive, the solution directive not enumerable as it inherits directly from the linked exercise.
+
+The following options are also supported:
 
 * `label` : text
 
@@ -83,9 +81,6 @@ A solution directive can be included using the `solution` pattern. It takes in t
 
     Removes the directive from the final output.
 
-```{note}
-The title of the solution directive links directly to the referred directive.
-```
 
 **Example**