Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Freeform language style guide #6

Open
stuartpb opened this issue Nov 12, 2017 · 1 comment
Open

Freeform language style guide #6

stuartpb opened this issue Nov 12, 2017 · 1 comment

Comments

@stuartpb
Copy link
Member

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
Copy link
Member Author

opws/opws-dataset#252 (comment) also had some good points about consistency in naming entries in the legal list.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant