Skip to content

Removing a section about Roles that I think has no real use-case #5184

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

Merged
merged 1 commit into from
Apr 17, 2015

Conversation

weaverryan
Copy link
Member

Hi guys!

Q A
Doc fix? no
New docs? no
Applies to 2.3+
Fixed tickets n/a

This came up after a conversation with someone on Twitter that got hung up on this section (they were also new to Doctrine, so the ManyToMany relationship was a bit challenging). But it occurred to me that this section is totally unnecessary for beginners, and maybe totally unnecessary for everyone. Is there a real-use case for this?

It was added 4 years ago at sha: 5a2824b, and it's original purpose was to talk
about Roles as domain objects. If this has a real-use case, then we should clarify
what it is, and move it to its own cookbook. This is a details that beginners are
trying to deal with, unnecessarily.

Thanks!

It was added 4 years ago at sha: 5a2824b, and it's original purpose was to talk
about Roles as domain objects. If this has a real-use case, then we should clarify
what it is, and move it to its own cookbook. This is a details that beginners are
trying to deal with, unnecessarily.
@javiereguiluz
Copy link
Member

👍 I fully agree with you.

@xabbuh
Copy link
Member

xabbuh commented Apr 16, 2015

👍 This will also (in a way) fix #5183.

@wouterj
Copy link
Member

wouterj commented Apr 16, 2015

👍

@stof
Copy link
Member

stof commented Apr 16, 2015

👍

@weaverryan
Copy link
Member Author

Thanks guys - sounds like a home run :)

@weaverryan weaverryan merged commit 6c9ce9c into 2.3 Apr 17, 2015
weaverryan added a commit that referenced this pull request Apr 17, 2015
…se-case (weaverryan)

This PR was merged into the 2.3 branch.

Discussion
----------

Removing a section about Roles that I think has no real use-case

Hi guys!

| Q             | A
| ------------- | ---
| Doc fix?      | no
| New docs?     | no
| Applies to    | 2.3+
| Fixed tickets | n/a

This came up after a conversation with someone on Twitter that got hung up on this section (they were also new to Doctrine, so the ManyToMany relationship was a bit challenging). But it occurred to me that this section is totally unnecessary for beginners, and maybe totally unnecessary for *everyone*. Is there a real-use case for this?

It was added 4 years ago at sha: 5a2824b, and it's original purpose was to talk
about Roles as domain objects. If this has a real-use case, then we should clarify
what it is, and move it to its own cookbook. This is a details that beginners are
trying to deal with, unnecessarily.

Thanks!

Commits
-------

6c9ce9c Removing a section about Roles that I think has no real use-case
@weaverryan weaverryan deleted the entity-remove-roles-section branch April 17, 2015 10:13
weaverryan added a commit that referenced this pull request Oct 15, 2015
…yan)

This PR was merged into the 2.3 branch.

Discussion
----------

[WIP] Reworking most of the registration form:

Hi guys!

| Q             | A
| ------------- | ---
| Doc fix?      | yes (because it's got bad recommendations)
| New docs?     | no
| Applies to    | 2.3+
| Fixed tickets | --

After trading emails with a user, I realized that we have this very out-dated registration form chapter. Wow :). A summary of the changes:

1) Showing the embedded Registration model is way too hard and unnecessary
2) Stopped persisted plainPassword (why did we do this?)
3) Used AppBundle approach
4) Annotation routing
5) various other small things

This is still a WIP only because I have 2 sections at the bottom I still want to add. Review for what is here now is appreciated.

Honestly, I was a little surprised that entries like this can "hide" in the docs and get so out of date. It's a testament to how big our docs are, but it's a bit of a problem (this is similar to #5184 that had something totally irrelevant in an important doc).

Things to update during merge:
- password encoder
- remove getName() in 2.8
- setDefaultOptions

Thanks!

Commits
-------

a8275a3 Fixing build error
8b7fc79 Tweaks thanks to everyone!
1c1b92a [WIP] Reworking most of the registration form:
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants