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

Documentation Guide - Querying / Filtering #1108

Open
hobofan opened this Issue Aug 15, 2017 · 4 comments

Comments

4 participants
@hobofan

hobofan commented Aug 15, 2017

Problem Description

Re: Better Documentation #853 Querying

What are you trying to accomplish?

  • Create an entry-level guide/reference on how to do the most common querying tasks. The ActiveRecord querying guide is a good example for that (though this guide obviously won't be on the same level for a long time).
  • The guide will be focused on "If you want to do this you have to do this" and will not go into too much depth on the traits behind the functionality and how to obtain them, as that will be covered by other guides (#1107)

Checklist

  • I have already looked over the issue tracker for similar issues.
@bovee

This comment has been minimized.

bovee commented Aug 29, 2017

A guide would be great, but even a table of SQL <-> Diesel would be super helpful. For example, I had difficulty finding out how to emit IN query statements without grepping the source (I think it's column.eq_any()?) and a list of column methods would have been incredibly useful.

@notryanb

This comment has been minimized.

Contributor

notryanb commented Oct 27, 2017

@hobofan - Just checking in to see if you're still working on this issue (or need help?). I think it is still a good idea and would be helpful with the 1.0 release just around the corner.

@hobofan

This comment has been minimized.

hobofan commented Oct 27, 2017

@notryanb Sorry, I got tied up in a fulltime freelancing contract the last two months. I'll be free again beginning next week, and this is one of the first things I'll work on!

@hobofan

This comment has been minimized.

hobofan commented May 17, 2018

I'm so sorry everyone that I was holding up this important part of the documentation for so long. I'm sadly constantly finding myself busy with other stuff and also haven't used Diesel since writing my last comment here, so I don't think I can write the documentation at the level it deserves.

It's probably best if someone else who is using this project more takes on this issue.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment