[quote=“edison”]
Unfortunately not in mine, and you are a prime example.[/quote]
I exactly agree with the OP here, and ironically I had the exact same problem too. I am trying to find a way to make simple templates for my Markdown files. I used to use RStudio, and RMarkdown, where you could just tell it to create a new RMarkdown file and it would generate a nice little template, albeit with too much text and samples, though it was still easier than starting from a blank document.
Here is another example, in searching for a resolution for this, I came across this Package:
packagecontrol.io/packages/FileHeader
Sounds good right? It seems to do exactly what I am trying to do. And unlike many other packages listed in there, it has a long description.
Except after you install the package, you realize that the description actually tells you absolutely nothing about how to use the package. Even the little animations do not help. My Sublime does not even look the same as the configuration they’re using there. I spent 20 minutes messing with everything on that page and still could not figure out how you are supposed to get that package to work. I checked the GitHub page, and the homepage, and it just repeats all the same unhelpful info. And after 20 minutes of messing with it, I could not find any place where I could post messages or comments asking for more clarification on the package. So not only is the description cryptic and unhelpful, but there is no readily apparent easy way to contact anyone affiliated or experienced with the package for more information. I think the OP here would agree that this is the kind of problem that Sublime has, in regards to ‘support’. And all this was the best I could get after a lot of Googling.
The Snippets page posted here (docs.sublimetext.info/en/latest/ … ppets.html) was actually very close to what I was looking for, and the page itself is exactly what I need; clear and detailed instructions. If you are making these kinds of packages, you need to write the descriptions in a narrative format, not in a code-commenting format as seems to be common. The description is for the layperson who has no clue what is going on, not for the fellow coder who has background knowledge on the subject. Telling me that “these are the available arguments” is absolutely useless if I don’t have a clue how to use or invoke any of them in the first place. Funny how the “Sublime Text Unofficial Documentation” is much more helpful than any “official” documentation that I’ve been able to find. To be clear, I am not saying that there are not good instructions out there; if there are, I have not been able to find them, which is itself part of the problem.