Guide for Diesel + Select statements

[weiznich]

I wrote a first draft of a guide covering how to construct select statements with diesel here. Before putting it onto our webpage as official guide I would like to see some feedback.

Beside the obvious language/grammar checks I would also be interested in having some feedback on the content itself. Is there something missing that you would like to see covered by such a guide? Is there anything in there that seems to be not meaningful or confusing? Are the examples easy enough to follow?

[Roardom]

I greatly appreciate this guide, thank you (I don't need it anymore, but it is definitely something I would have found very useful when starting out).

One small thing that caught my eye was the lack of uses. I notice you added use crate::schema::users; in one of the examples near the end, but I think it would be more beneficial to be added in one of the beginning examples. I recall years ago when first using diesel having difficulty figuring out where all the symbols were imported from (mainly due to rust-analyzer's auto-suggest not being too helpful), even though it doesn't seem to be a big deal for me anymore.

[weiznich]

Thanks for reading over it 🙏

That's a goof idea to include the relevant imports. That hopefully should make it a bit easier to understand what is going on. Maybe I should also add a sentence to the getting started guide to linke the schema in depth guide for details on how exactly that module structure looks like?

[Roardom]

I don't think a link to the schema in depth guide within the getting started guide would have been useful for me. However, I went to try and find a good place in the guide to add it, since it was a good idea regardless, and it looks like it already exists: https://github.com/sgrif/diesel.rs-website/blob/25a2a888112ccf9f9467d9294f726b0d82fd9c48/src/guides/getting-started.md#L671-L673