Add documentation for Treesitter capture groups

[bew]

The plugin uses many query files for Treesitter support, using capture groups like @scope.tag, @open.tag, ..
I wanted to experiment with changing some queries, or add new queries for a custom languages, BUT I couldn't find any documentation for these capture groups.

👉 Could you please add some documentation (in help file at least) for these?

---

Related question: why are the TS queries in /after/queries/ instead of in /queries/ like most other TS plugins like nvim-treesitter ? (this makes it a little awkward to override those query files, most of my overrides are in /queries/ and I'd have to have a separate set of overrides for matchup 🤔)

[andymass]

There is some brief documentation in the wiki: https://github.com/andymass/vim-matchup/wiki/Supporting-a-new-language-(tree-sitter)

The basic requirement is each logical group "tag" consists of:

@scope.tag [ 
  @open.tag ..
  @mid.tag.x (x=1,...,n; optional)
  @close.tag (optional)
]

Then match-up with enable % to toggle between open->mid->close or if there is no close then a virtual close at the end of the logical scope.

---

You should be able to put your overrides in queries/.. alternatively. Then I suppose the issue is that after/queries/.. takes precedence over your own local configuration? I think there was not a reason for this choice. Let me know if queries/.. doesn't work.