Add Documentation for ApplyTransforms, and Add Resources to Each and PgSelect Docs

[iamameme]

Description

In my usage of Grafast at my workplace for the past few months, I've fallen in love with it. I've also obtained some learnings that I wish I had read in the docs. This is focused mainly around modifying the keys/values returned from a PgSelect. We have been working through the unique case of having to support a legacy GraphQL schema while not wanting that to affect our database design. This meant writing plans to resolve fields that required changing the returned keys and values from the DB a lot.

Hopefully, these changes might help others that run into similar use-cases.

• Add a new docs page for the ApplyTransforms step
• Add a new section in the each step docs with more example usage
• Add a new section in PgSelect to link to each and applyTransforms to describe additional behavior a user may be interested in

Question that prompted this: #2161

Performance impact

• None

Security impact

• None

Checklist

• None (Doc changes)

[changeset-bot]

⚠️ No Changeset found

Latest commit: b7ae095

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[benjie]

Thanks so much for contributing some documentation! Just a heads up that this is an unusually busy time for me: I just came back from vacation yesterday and on Saturday I'll be flying to America for GraphQLConf where I have two unfinished talks to present, so it may take me a few weeks to get around to reviewing it fully. I might do a cursory review before then if I get a chance, but it is likely to take a while to get merged. Sorry!

[benjie]

Thanks! This was a really great start; I've applied some editorial and clarified what the issue is and what's affected. I've also tried to avoid referencing PostGraphile-specifics in the grafast documentation, since grafast should know nothing of PostGraphile. I think this is good to go! 🙌