Use more Sphinx directives.

[modelmat]

This is a list of a few Sphinx directives that I think might be useful to add (if not just because Sphinx provides them), sorted in roughly "wantedness":

.. glossary / :term:

Allows to create a glossary of terms. This would be quite useful, especially in more complex sections.

.. sectionauthor

Specifies who wrote the majority of the current section. Useful for when clarification is needed.
Might be a pain if only one author is allowed.
Does not by default get rendered in output.

:file:

Used for naming files. Apparently this looks different?

:kbd:

Used to represent keyboard strokes. This uses the HTML tag <kbd> and hence draws a box around the key.

[AustinShalit]

glossary and term seem interesting.

I do not think we need section author.

Not sure what file will do/how it changes what end users see.

When do you think we would use kbd over tick marks?

[modelmat]

:kbd: will allow expressions such as ctrl + shift + t to represented as Ctrl + Shift + T.

:file: seems to be when you have a part of the filename that changes - see http://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#role-file which italicises the section inside {x}

Maybe not that useful.

section author, I'm guessing no because we have git already?

[AustinShalit]

Oh... I see now about kbd. Seems cool.

I am not sure where we would use file because hopefully the documents are becoming year agnostic.

Yup. Section authors are redundant with git.

[sciencewhiz]

@modelmat When I looked at the generated file from #295, there's very little distinction of the text in the :kbd: directive. It is not outlined like your example. Unless there's a way to make it more visually distinctive (like your example), I don't think it's worth it.

[sciencewhiz]

Looks like better formatting for the kbd directive will be in the next RTD theme release. readthedocs/sphinx_rtd_theme#677

[Daltz333]

Closing as it's not really an issue, and we are using glossary. Something to keep in mind going forward