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

Documentation eratta regarding standards #13

Open
Myndex opened this issue Jul 12, 2023 · 0 comments
Open

Documentation eratta regarding standards #13

Myndex opened this issue Jul 12, 2023 · 0 comments
Labels
documentation Improvements or additions to documentation

Comments

@Myndex
Copy link

Myndex commented Jul 12, 2023

Standards

...While no standard exists...

There are actually several independent standards, several of which are extraordinarily detailed.

The Chicago Manual of Style

The Associated Press Stylebook

Modern Language Association Handbook

There are some occasional incompatibilities between standards relating to syntax, for instance the AP style book does not utilize the Oxford comma syntax, while the Chicago Manual of style does. Using one when the other is called for can result in parsing errors, therefore it is preferred to stick to one standard.

And regarding:

...English follows a Write Once, Read Anywhere, Then Rewrite (WORATR) philosophy....

It is often said that writing is rewriting, as such I would assert that the English dev environment follows a "write/rewrite, post, and read" paradigm (WRPAR, commonly pronounced 'warper' or 'werper', depending on regional dialects).

I already have a pull request #12 and I could add these as commits if you like...

Best regards,

Andy Somers
Chief Quibbling Officer
Ministry of Prolixity
South Wales, UK

@theletterf theletterf added the documentation Improvements or additions to documentation label Jul 13, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

2 participants