openSUSE/suse-doc-style-checker

Consider some rules from OpenStack writing guidelines

Closed this issue · 2 comments

Just for the record (nothing important nor fancy).

For example, the OpenStack community has some General writing guidelines.

Some rules could be interesting for our style checker too: Write positively, Avoid prepositions at the end of sentences, Do no overuse this, that, these, and it and probably more.

Probably not all are useful or can even be transformed into a specific regex.

I guess this should better be at https://github.com/SUSE/doc-styleguide . -> Closing here, reopened as SUSE/doc-styleguide#61.

Thanks, for opening it on the SUSE domain too. I first thought about adding some rules in the style checker. But probably that way is even better: first digest the other guide and then try to extract and create some meaningful rules for it. 😸