feat(velocity): document velocity-plugin.json file

[Strokkur424]

closes #731

I actually decided against outright removing mentions of the AP, as it is useful for beginners and honestly doesn't really hurt most people. But having the actual file documented seems like a good thing.

[github-actions]

built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Name	Status	Preview	Last Commit
papermc-docs	✅ Ready (View Log)	Visit Preview	fbc45ca

[Timongcraft]

I think it should either be mentioned what the name and ID are actually for, because most logging just uses the ID so either that should be refactored, or this behaviour be documented. (The name is also mostly in-game facing)
I'm also not sure why you omitted parts of the spec in your example, because I think the author/url field is a good source indicator, that should be recommended.
Also I think this page could be a bit more compact, like putting a required indicator in your example or in the header of the entries itself and/or not have these giant spaces.
Lastly IMO the page should be under the "Creating your first plugin" page or be a sub-page and be mentioned in the:
https://papermc-feat-velocity-plugin.papermc-docs.pages.dev/velocity/dev/creating-your-first-plugin/#setting-up-the-dependency section, not just the file itself.

[Timongcraft]

Also I'm not sure how to address that but the fields are kinda duplicated now:
https://papermc-feat-velocity-plugin.papermc-docs.pages.dev/velocity/dev/creating-your-first-plugin/#setting-up-a-velocity-project
and
https://papermc-feat-velocity-plugin.papermc-docs.pages.dev/velocity/dev/velocity-plugin-json/#fields
where the latter doesn't have as much info though.

[zlataovce]

I don't think the Velocity plugin file is JSONC to allow comments and I expect some people will copy-paste the code block and wonder why it doesn't work; using line markers from EC might be the way to go: https://expressive-code.com/key-features/text-markers/#adding-long-labels-on-their-own-lines

[Strokkur424]

Oh yeah, that's a thing. Thank you for the suggestion!