Documentation of Syntax Naming Conventions

[leoheck]

Hi, its possible to update the documentation with the _Naming Conventions_ for syntax files?
You can search the some information here (I believe that is the same for sublime):
http://manual.macromates.com/en/language_grammars

[FichteFoll]

Check the Textmate online manual for guidance on scope names.

This section is actually in the documentation and has initially led me to browse the docs in order to find scope names for my first syntax, but I agree that this is definitely not enough. We might as well mirror the TM docs and add a few other conventions like the punctuation thing.

I think we should add a separate doc about scopes and scope selectors for this purpose that we can also link from syntax definitions and color schemes.

[leoheck]

A separate doc should be fine. Thanks.

[jcrben]

As far as #69 this seems to be covered in more detail at http://sublimetext.info/docs/en/extensibility/syntaxdefs.html#scopes-and-scope-selectors - the equivalent page here might be http://sublime-text-unofficial-documentation.readthedocs.org/en/latest/reference/syntaxdefs.html but it is more limited.

[FichteFoll]

ed6fba5 adds a reference to the official docs in our color scheme docs.

I will take a look at our syntax docs at another time.