-
Notifications
You must be signed in to change notification settings - Fork 281
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
Improve title #232
Comments
I should actually remove those first-person references as they are just a remnant of the early days of the style guide (and I'll take a note to do so). I think the name is fine as it is - it has been around for a very long time and nobody was been concerned with the name being confusing so far. |
Let's adopt language that reflects better the community-driven nature of the guide.
@bbatsov I contributed this issue not to change the introduction text, but the title. Because the title is deceiving.
Happy to open a new issue if necessary. |
"The Clojure Style Guide" as a title projects much more authority than this document has or should have. By using the definitive form it leaves no space for other. It makes unsuspecting readers believe that it is some official reference to adhere to. In sharp contrast, its introduction already clarifies that it consists of personally opinionated rules somebody assembled based on his "extensive career as a software engineer". This is a source for much confusion.
Here are some brainstormed ideas to improve upon:
The text was updated successfully, but these errors were encountered: