Skip to content

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
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
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

4 participants