From d72a32d1147066f259bb33aea9a24e6acef264dc Mon Sep 17 00:00:00 2001 From: Bukkit/Spigot Date: Thu, 24 Mar 2022 13:39:30 +1100 Subject: [PATCH] #736: Update README By: Doc --- paper-api/README.md | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-) diff --git a/paper-api/README.md b/paper-api/README.md index 31c5e1cdd1..8ae666096f 100644 --- a/paper-api/README.md +++ b/paper-api/README.md @@ -1,6 +1,6 @@ Bukkit ====== -A plugin API for [Minecraft](https://minecraft.net/) servers, currently maintained by [SpigotMC](http://www.spigotmc.org/). +A plugin API for [Minecraft](https://minecraft.net/) servers, currently maintained by [SpigotMC](https://www.spigotmc.org/). #### Index * [Bug Reporting](#bug-reporting) @@ -11,11 +11,13 @@ A plugin API for [Minecraft](https://minecraft.net/) servers, currently maintain Bug Reporting ------------- -The development team is very open to both bug and feature requests / suggestions. You can submit these on the [JIRA Issue Tracker](http://hub.spigotmc.org/jira/). + +The development team is very open to both bug and feature requests / suggestions. You can submit these on the [JIRA Issue Tracker](https://hub.spigotmc.org/jira/). Compilation ----------- -Bukkit is a Java program which uses [Maven 3](http://maven.apache.org/) for compilation. To compile fresh from Git, simply perform the following steps: + +Bukkit is a Java program which uses [Maven 3](https://maven.apache.org/) for compilation. To compile fresh from Git, simply perform the following steps: * Install Maven and Git using your preferred installation methods. * `git clone https://hub.spigotmc.org/stash/scm/spigot/bukkit.git`. @@ -25,10 +27,11 @@ Some IDEs such as [NetBeans](https://netbeans.org/) can perform these steps for Contributing ------------ + Contributions of all sorts are welcome. To manage community contributions, we use the pull request functionality of Stash. In to gain access to Stash and create a pull request, you will first need to perform the following steps: -* Create an account on [JIRA](http://hub.spigotmc.org/jira/). -* Fill in the [SpigotMC CLA](http://www.spigotmc.org/go/cla) and wait up to 24 hours for your Stash account to be activated. Please ensure that your username and email addresses match. +* Create an account on [JIRA](https://hub.spigotmc.org/jira/). +* Fill in the [SpigotMC CLA](https://www.spigotmc.org/go/cla) and wait up to 24 hours for your Stash account to be activated. Please ensure that your username and email addresses match. * Log into Stash using your JIRA credentials. Once you have performed these steps you can create a fork, push your code changes, and then submit it for review. @@ -39,9 +42,10 @@ Although the minimum requirement for compilation & usage is Java 8, we prefer al Bukkit's Goals -------------- + As a rough guideline, ask yourself the following questions to determine if the proposed change fits the Bukkit project's goals. Please remember that this is only a rough guideline and it may or may not reflect the definitive answer to this question. -Discussions about proposed changes are held in the [Spigot IRC](https://www.spigotmc.org/wiki/irc-guide/). +Discussions about proposed changes are held in the [Spigot Discord](https://www.spigotmc.org/go/discord). * Does it expose an implementation detail of the server software, or the protocol or file formats? @@ -63,7 +67,8 @@ Regardless, there are a few other important questions that need to be asked befo Code Requirements ----------------- -* For the most part, CraftBukkit and Bukkit use the [Sun/Oracle coding standards](http://www.oracle.com/technetwork/java/javase/documentation/codeconvtoc-136057.html). + +* For the most part, CraftBukkit and Bukkit use the [Sun/Oracle coding standards](https://www.oracle.com/technetwork/java/javase/documentation/codeconvtoc-136057.html). * No tabs; use 4 spaces instead. * Empty lines should contain no spaces. * No trailing whitespaces. @@ -79,7 +84,7 @@ Code Requirements * Avoid moving or renaming classes. * All non-private methods and constructors must have specified nullability through [annotations](https://github.com/JetBrains/java-annotations) -Bukkit/CraftBukkit employs [JUnit 4](http://www.vogella.com/articles/JUnit/article.html) for testing. Pull Requests(PR) should attempt to integrate within that framework as appropriate. +Bukkit/CraftBukkit employs [JUnit 4](https://www.vogella.com/tutorials/JUnit4/article.html) for testing. Pull Requests(PR) should attempt to integrate within that framework as appropriate. Bukkit is a large project and what seems simple to a PR author at the time of writing may easily be overlooked by other authors and updates. Including unit tests with your PR will help to ensure the PR can be easily maintained over time and encourage the Spigot team to pull the PR. @@ -88,4 +93,4 @@ will help to ensure the PR can be easily maintained over time and encourage the * Do not group packages * __Absolutely no wildcard imports outside of tests.__ -Any questions about these requirements can be asked in #spigot-dev in IRC. +Any questions about these requirements can be asked in #help-development in Discord.