Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve Brigadier Documentation #507

Open
wants to merge 95 commits into
base: main
Choose a base branch
from

Conversation

Strokkur424
Copy link
Contributor

@Strokkur424 Strokkur424 commented Dec 14, 2024

This PR aims to improve the documentation for Paper's new way of declaring commands using the Brigadier API.

Tip

I suppose this PR is now mergable. Not all content points have been included yet, but I will be declaring seperate PRs for those. This PR is big enough as-is

Roadmap:

Content

  • Add Bukkit <-> Paper command comparison
  • Introduction page
  • Command Tree Structure
  • Arguments and Literals
  • The executes method
  • The requires method
  • Native Arguments (StringArgumentType, IntegerArgumentType, etc)
  • Registering Brigadier Commands
  • BasicCommand
  • Minecraft Arguments
  • Registry Arguments (The current arguments page)
  • Examples (Separate PR)
  • Custom Arguments (Separate PR)
  • Common Issues (Separate PR)
  • Quick reference (Separate PR)
  • FAQ (Separate PR)
  • Advanced (dispatcher and fork) (Separate PR)

Finalization

  • Add Javadocs links where ever possible
  • Final revision (Mergable)

Reasons for opening a PR:

I wanted to open this PR so that other people could check out the current state of things and help me improve (and potentially even correct me on) the documentation I am writing. I want to make sure that everybody, beginner or advanced, can understand everything written here with ease, because the Brigadier system is less scary than it sounds, yet it is not well documented.

If you want to help contribute:

There is two ways you can help me with this PR:

  1. Start a code review and just highlight any issues you see with the current state of things. I will try my best to improve on those issues.
  2. Open a PR to my fork/branch. This would make sense for new pages, but for editing existing pages, unless the change is big, I would prefer the first option.

If you have any suggestions...

...please do not hesitate to comment on this PR. I will take all suggestions into consideration.

Let's make the docs even better 🚀

@Strokkur424 Strokkur424 marked this pull request as draft December 14, 2024 11:15
Copy link

github-actions bot commented Dec 14, 2024

built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

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

Copy link
Member

@olijeffers0n olijeffers0n left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The docs are really good. Couple of nitpicks that i saw though.

I am concerned about the video file size a little bit. One is 20MB. These could be compressed potentially but unsure if this is the best route to take. I know this was discussed in the past

docs/paper/dev/api/command-api/basics/introduction.mdx Outdated Show resolved Hide resolved
docs/paper/dev/api/command-api/misc/basic-command.mdx Outdated Show resolved Hide resolved
@Strokkur424
Copy link
Contributor Author

I am concerned about the video file size a little bit. One is 20MB. These could be compressed potentially but unsure if this is the best route to take. I know this was discussed in the past

I haven't been made aware of any such discussions. If you wish, I can reduce the file sizes a bit

@Strokkur424
Copy link
Contributor Author

I reduced the file sizes very drastically whilst still keeping it somewhat high-quality. Hopefully that should be enough?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

needs a redirect to not kill existing links

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

needs a redirect to not kill existing links

Strokkur424 and others added 20 commits January 11, 2025 15:57
Co-authored-by: Matouš Kučera <[email protected]>
Co-authored-by: Matouš Kučera <[email protected]>
Co-authored-by: Matouš Kučera <[email protected]>
Co-authored-by: Matouš Kučera <[email protected]>
Co-authored-by: Matouš Kučera <[email protected]>
Co-authored-by: Matouš Kučera <[email protected]>
Co-authored-by: Matouš Kučera <[email protected]>
Co-authored-by: Matouš Kučera <[email protected]>
Co-authored-by: Matouš Kučera <[email protected]>
Co-authored-by: Matouš Kučera <[email protected]>
Co-authored-by: Matouš Kučera <[email protected]>
Co-authored-by: Matouš Kučera <[email protected]>
Co-authored-by: Matouš Kučera <[email protected]>
Co-authored-by: Matouš Kučera <[email protected]>
Pretty sure I just had that temporarily in whilst writing. My bad

Co-authored-by: Matouš Kučera <[email protected]>
Co-authored-by: Matouš Kučera <[email protected]>
Co-authored-by: Matouš Kučera <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants