8000 Removed the term "simple" from creating a new page by linaori · Pull Request #9791 · symfony/symfony-docs · GitHub
[go: up one dir, main page]
Skip to content

Removed the term "simple" from creating a new page #9791

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.

Sign up for GitHub

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

Jump to bottom
Merged
merged 1 commit into from
May 18, 2018
Merged

Removed the term "simple" from creating a new page #9791

merged 1 commit into from
May 18, 2018

Conversation

linaori
Copy link
Contributor
@linaori linaori commented May 17, 2018

Something that's simple for me, might not be simple for a developer who is new to Symfony. I think this is a friendlier approach to the process of creating a new page.

I haven't checked the other docs as I quickly pressed edit when I noticed this.

@javiereguiluz
Copy link
Member

Thanks for this! We are aware of how bad some words are for tech docs:

  • obviously
  • basically
  • simply
  • of course
  • clearly
  • just
  • as everyone knows
  • however
  • so
  • easy
  • etc.

However, removing all of them from our docs is not easy at all. Please don't send PRs changing hundreds of occurrences of those words because they will be rejected. They would cause thousands of merge conflicts and we don't have time for that.

We'll fix this eventually ... but we'll need to prepare for that. Thanks for understanding it.

@javiereguiluz javiereguiluz added this to the 2.7 milestone May 17, 2018
@javiereguiluz
Copy link
Member

Thanks @iltar.

@javiereguiluz javiereguiluz merged commit 292d6ea into symfony:2.7 May 18, 2018
javiereguiluz added a commit that referenced this pull request May 18, 2018
@javiereguiluz
minor #9791 Removed the term "simple" from creating a new page (iltar)
7328eec 
This PR was merged into the 2.7 branch.

Discussion
----------

Removed the term "simple" from creating a new page

Something that's simple for me, might not be simple for a developer who is new to Symfony. I think this is a friendlier approach to the process of creating a new page.

I haven't checked the other docs as I quickly pressed edit when I noticed this.

Commits
-------

292d6ea Removed the term "simple" from creating a new page
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@xabbuh xabbuh xabbuh approved these changes

Assignees
No one assigned
Labels
Status: Reviewed
Projects
None yet
Milestone
2.7
Development

Successfully merging this pull request may close these issues.
4 participants
@linaori @javiereguiluz @xabbuh @carsonbot
0