Style Guide

[mmcky]

Display Math (no-labels)

$$\psi_t = N(\mu_t, v_t)$$

should be

$$
\psi_t = N(\mu_t, v_t)
$$

[najuzilu]

Are there guidelines on using $$ vs a math directive? If yes, we should make that explicit in the myst-parser documentation. This example only uses a math directive when labels are added.

[mmcky]

I would suggest use $$ for any unlabelled math and then use full math directives for labelled math or any other required tags (in the future)

[najuzilu]

I want to clarify which syntax is preferred regarding these two directive examples. @mmcky any feedback would be greatly appreciated.

1. Example 1

```{directive}
:option: value

content
```

2. Example 2

```{directive}
---
option: value
---
content
```