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

Remove all uses of just, simple, simply, and straighforward in the docs #936

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

ayushn21
Copy link
Member

@ayushn21 ayushn21 commented Nov 8, 2024

As it says on the tin .... I think in most cases these words don't add a lot of value and come across as patronising. I've rewritten lines in the docs where I've felt it appropriate ... but for the most part it was "find and delete".

My motivation for this came from:
https://justsimply.dev
http://jackkelly.name/blog/archives/2019/09/20/avoid_just_and_simply_in_documentation/index.html

@jaredcwhite
Copy link
Member

Ooo, I like this @ayushn21! Good call.

I have a another WIP PR, #912 with a bunch of docs updates for v2.0, so I'm thinking I'll comb through that and make similar improvements, and then we'll have to figure out how to merge that and this together without bewildering conflicts…

@ayushn21
Copy link
Member Author

ayushn21 commented Nov 11, 2024

we'll have to figure out how to merge that and this together without bewildering conflicts

Welp. yeah that'll be tricky. Let me know if you need me to look at anything!

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

Successfully merging this pull request may close these issues.

2 participants