Add examples to show how things are used.

[uscholdm]

Put in a separate examples folder.

[uscholdm]

I am working on this.

[uscholdm]

This is a very large task, given there are so many different parts of gist to illustrate. I will start somewhere and come up with some conventions for how to do this. I might start with Collections and OrderedCollections as I have some examples from client work.

[rjyounes]

I'd like to consider moving these to the gist-doc repository so they are not tied to our release schedule. If they are distributed with a release, it creates a lot of additional work to update the examples accordingly. Even if not distributed in a release, I think the implication would be that they are being kept up-to-date with the develop branch, surely to onerous a task when making changes to gist. The gist-doc repo can get out of sync with the current state of gist, either released or in development, without creating confusion as long as it's made clear in the readme. @pwin's documentation in that repo, for example, is not updated on the same schedule as gist.

[uscholdm]

This is an excellent point.

[rjyounes]

Closing - examples will reside in gist-doc repo, @uscholdm to create new issue there.

@semartsofficemanager Move documentation section higher up on SA website gist page.

[uscholdm]

Closing - examples will reside in gist-doc repo, @uscholdm to create new issue there.

Issue created: semanticarts/gist-doc#7

[JonathonGist]

Thank you team for doing this--I can hardly wait to read it, when I get some time.