docs where additional details is used need more description

[ergz]

there are docs that link to the long from type of documentation, try to either link the long form documentation without the need of an additional click, or add a more descriptive link instead of just "more details"