Docstring improvements for hidedecorations!, etc.

[jwahlstrand]

Description

Describe what the keyword arguments of hidedecorations!, hidexdecorations!, etc. do. Also fix a few other docstrings.

Fixes #2846

Type of change

Delete options that do not apply:

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)

Checklist

• Added an entry in NEWS.md (for new features and breaking changes)
• Added or changed relevant sections in the documentation
• Added unit tests for new algorithms, conversion methods, etc.
• Added reference image tests for new plotting functions, recipes, visual options, etc.

[jkrumbiegel]

In principle good, but I think we had problems with @ref links in docstrings because we don't use documenter. Maybe just remove the links from those mentions for now?

[jwahlstrand]

Sounds good, I removed @ref.