Flutter api docs

[fjnoyp]

Docs for the Flutter API category

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[haverchuck]

See comments. Looks good overall.

[haverchuck]

I'm approving this contingent on confirmation that all code fragments were tested.

[Amplifiyer]

are there multiple OIDC modes? We should either say OIDC modes are ... or OIDC mode is ...

[Ashish-Nanda]

Fixed

[Amplifiyer]

Is it possible to show how to retrieve this Id from the mutation result? Based on our example schema and selection set used in mutation, it should be consistent on how Id gets retrieved instead of using a dummy Id here.

[Ashish-Nanda]

This section actually starts with Now that you were able to make a mutation, take the 'id'... and references the previous section which demonstrated how to run a mutation and get the result.
iOS docs also pass in a dummy id like this for getTodo. Android passes an id variable but then is enclosed in a function that takes id as an argument. So would rather just keep this similar to iOS.

[Amplifiyer]

Since we only have advanced flows, and nowhere in our docs we are showing how to access the data, I think it's a huge value add here to show, and possibly in other examples as well (e.g. a query example)

[Ashish-Nanda]

Added details for how to work with the mutation response as discussed.

[jamesonwilliams]

Overall, I think this needs one more round and then it should be ready to ship.

Many small suggestions inline. Please take as click-to-accept as many of the easy ones as you can.

I also think you can de-duplicate some existing text ("Upon completion..."). There are already a lot of copies of this same text in the docs content, and this PR is adding more.

[Ashish-Nanda]

LGTM 🚀

[Amplifiyer]

should have been amplify_core