Enforce proper definition list markup syntax

our docs currently do something like this:

```
:Configured Shards:

  The `number of configured shards`_
```

the correct format is this:

```
**Configured Shards**:
  The `number of configured shards`_
```
