3 ms·
They have rules loaded that are primarily for writing technical documentation. (I assume the tap/touch is from the Google rules). Most technical documentaitio
by aidenn0 4y ago
They have rules loaded that are primarily for writing technical documentation. (I assume the tap/touch is from the Google rules). Most technical documentaition style guides will recommend avoiding first person, but that makes zero sense for e.g. a blog post. Assuming ALL CAPS words are likely to be acronyms is also reasonable in such a context.
Vale also has multiple severity levels, so disabling e.g. the "suggestion" (and maybe even "warning") level while writing live would make a lot of sense.
- leephillips 4y ago“Most technical [documentation] style guides will recommend avoiding first person” Not even true. They recommend against first person singular.
- cbsks 4y agoGoogle recommends avoiding first person: https://developers.google.com/style/person https://developers.google.com/style/person