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

Where is the builder pattern described in the book? #1818

Closed
ckaran opened this issue Feb 15, 2019 · 6 comments
Closed

Where is the builder pattern described in the book? #1818

ckaran opened this issue Feb 15, 2019 · 6 comments

Comments

@ckaran
Copy link

ckaran commented Feb 15, 2019

Rust references the 'builder pattern' in a number of locations, so I decided to see what the book had to say about it. As near as I can tell, it isn't described in the current edition. The only reference I found was via google to the 1.0.0 docs, and a couple of closed bug reports (1 and 2) saying that it was being worked into Chapter 17, but other than that, nothing. Did it get lost somewhere?

@carols10cents
Copy link
Member

Yes, we decided to take Chapter 17 in a different direction, and we don't have plans to add it back at this point. There are a LOT of patterns we could have covered but we don't have room to discuss them all-- please see the rust-unofficial/patterns repo for documentation on them. Thanks!

@ckaran
Copy link
Author

ckaran commented Mar 15, 2019

I understand why you wouldn't want to list all design patterns, but I think the builder pattern is special in rust; it is referenced a lot, and rust has its own idiomatic way of using it. There needs to be a more official place for it than rust-unofficial.

@platy
Copy link

platy commented Feb 9, 2021

There is an explanantion under Type Safety of the api guidelines.

@ckaran
Copy link
Author

ckaran commented Feb 9, 2021

Thank you for the link @platy.

I think my bigger concern is that all these ideas are well-documented, but finding them can be difficult. AFAIK, there is no direct link from the docs page to things like the rust API guidelines. But that's a problem for a separate issue...

@platy
Copy link

platy commented Feb 9, 2021

I'm a bit concerned about that too, I came across that page (and the API guidelines) for the first time last week. When trying to find it again today I landed here , I thought that link might help others find it. I think there could be more cross linking between the books.

@ckaran
Copy link
Author

ckaran commented Feb 10, 2021

For what it's worth, I opened a new issue regarding documentation here.

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

No branches or pull requests

3 participants