You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Explain the feature or enhancement in detail
Overall it's an issue that keeps coming up: improper or over use of parenthesis.
The most egregious example I see is putting navigational instructions in parenthesis, when it's not part of an active instruction.
I'd ideally like to see very low/no parenthesis use in the documentation since it's often a proxy for unclear writing, and, unsurprisingly, it only adds noise to documentation instructions.
Can we create a warning for body content (excluding tags) when there is more than 2 or 3 instances of parenthesis pairs? Can also add an explicit rule that looks for :menuselection: inside of parenthesis.
Screenshots
N/A
Additional context
N/A
The text was updated successfully, but these errors were encountered:
Explain the feature or enhancement in detail
Overall it's an issue that keeps coming up: improper or over use of parenthesis.
The most egregious example I see is putting navigational instructions in parenthesis, when it's not part of an active instruction.
I'd ideally like to see very low/no parenthesis use in the documentation since it's often a proxy for unclear writing, and, unsurprisingly, it only adds noise to documentation instructions.
Can we create a warning for body content (excluding tags) when there is more than 2 or 3 instances of parenthesis pairs? Can also add an explicit rule that looks for :menuselection: inside of parenthesis.
Screenshots
N/A
Additional context
N/A
The text was updated successfully, but these errors were encountered: