search

opws / opws-guidelines

Policies, procedures, recommendations, and other OPWS bureaucracy
0 stars 0 forks source link

Freeform language style guide #6

Open stuartpb opened 6 years ago

stuartpb commented 6 years ago

Proposed in opws/opws-dataset#194 - while that issue made the good point that language too codified is an anti-pattern for language that should be represented in actual code (ie. structured fields), there should probably be some best practices around writing en_US memos, like not using first/second/third person pronouns (describe it as "the site", etc).

These kinds of rules probably also extend out to other languages.

stuartpb commented 6 years ago

https://github.com/opws/opws-dataset/issues/252#issuecomment-282607845 also had some good points about consistency in naming entries in the legal list.