Update typos and javadocs

Author: malczuuu

src/main/java/io/github/malczuuu/problem4j/core/ProblemStatus.java

@@ -26,8 +26,59 @@
  * <p>This enum can be used to represent response status codes in a library-agnostic way, without
  * introducing dependencies on specific frameworks like Spring.
  *
- * @see <a href="https://datatracker.ietf.org/doc/html/rfc9110#name-status-codes">RFC9110 - HTTP
- *     Semantics</a>
+ * <p><b>Referenced RFC sources (chronological)</b>:
+ *
+ * <ul>
+ *   <li><b>1998-03</b> - RFC 2295: Transparent Content Negotiation in HTTP (<a
+ *       href="https://datatracker.ietf.org/doc/html/rfc2295">link</a>) - introduces 506 Variant
+ *       Also Negotiates.
+ *   <li><b>1998-04</b> - RFC 2324: Hyper Text Coffee Pot Control Protocol (HTCPCP/1.0) (<a
+ *       href="https://datatracker.ietf.org/doc/html/rfc2324">link</a>) - adds novelty code 418 I'm
+ *       a teapot.
+ *   <li><b>1999-02</b> - RFC 2518: HTTP Extensions for Distributed Authoring (WebDAV) (<a
+ *       href="https://datatracker.ietf.org/doc/html/rfc2518">link</a>) - defines 102 Processing,
+ *       207 Multi-Status, 422 Unprocessable Entity, 423 Locked, 424 Failed Dependency.
+ *   <li><b>1999-06</b> - RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1 (Obsoleted) (<a
+ *       href="https://datatracker.ietf.org/doc/html/rfc2616">link</a>) - core set:
+ *       100,101,200–206,300–305,400–417,500–505.
+ *   <li><b>2000-02</b> - RFC 2774: An HTTP Extension Framework (<a
+ *       href="https://datatracker.ietf.org/doc/html/rfc2774">link</a>) - adds 510 Not Extended.
+ *   <li><b>2002-01</b> - RFC 3229: Delta encoding in HTTP (<a
+ *       href="https://datatracker.ietf.org/doc/html/rfc3229">link</a>) - adds 226 IM Used.
+ *   <li><b>2007-06</b> - RFC 4918: WebDAV (replacing RFC 2518) (<a
+ *       href="https://datatracker.ietf.org/doc/html/rfc4918">link</a>) - re-specifies
+ *       102,207,422,423,424; adds 507 Insufficient Storage.
+ *   <li><b>2010-05</b> - RFC 5842: Binding Extensions to WebDAV (<a
+ *       href="https://datatracker.ietf.org/doc/html/rfc5842">link</a>) - adds 208 Already Reported,
+ *       508 Loop Detected.
+ *   <li><b>2012-04</b> - RFC 6585: Additional HTTP Status Codes (<a
+ *       href="https://datatracker.ietf.org/doc/html/rfc6585">link</a>) - adds 428 Precondition
+ *       Required, 429 Too Many Requests, 431 Request Header Fields Too Large, 511 Network
+ *       Authentication Required.
+ *   <li><b>2014-06</b> - RFC 7231: HTTP/1.1 Semantics and Content (<a
+ *       href="https://datatracker.ietf.org/doc/html/rfc7231">link</a>) - deprecates 305 Use Proxy;
+ *       renames 413 Request Entity Too Large → Payload Too Large; 414 Request-URI Too Long → URI
+ *       Too Long.
+ *   <li><b>2015-04</b> - RFC 7538: Status Code 308 (Permanent Redirect) (<a
+ *       href="https://datatracker.ietf.org/doc/html/rfc7538">link</a>) - adds 308 Permanent
+ *       Redirect.
+ *   <li><b>2015-05</b> - RFC 7540: HTTP/2 (<a
+ *       href="https://datatracker.ietf.org/doc/html/rfc7540">link</a>) - adds 421 Misdirected
+ *       Request.
+ *   <li><b>2016-02</b> - RFC 7725: An HTTP Status Code to Report Legal Obstacles (<a
+ *       href="https://datatracker.ietf.org/doc/html/rfc7725">link</a>) - adds 451 Unavailable For
+ *       Legal Reasons.
+ *   <li><b>2018-01</b> - RFC 8297: Indicating Hints (<a
+ *       href="https://datatracker.ietf.org/doc/html/rfc8297">link</a>) - adds 103 Early Hints;
+ *       obsoletes informal 103 Checkpoint name.
+ *   <li><b>2018-09</b> - RFC 8470: Using Early Data in HTTP (<a
+ *       href="https://datatracker.ietf.org/doc/html/rfc8470">link</a>) - adds 425 Too Early.
+ *   <li><b>2022-06</b> - RFC 9110: HTTP Semantics (<a
+ *       href="https://datatracker.ietf.org/doc/html/rfc9110">link</a>) - renames 413 Payload Too
+ *       Large → Content Too Large; 416 Requested Range Not Satisfiable → Range Not Satisfiable; 422
+ *       Unprocessable Entity → Unprocessable Content; consolidates prior semantics.
+ * </ul>
+ *
  * @see <a href="https://http.cat/">HTTP Cats</a>
  * @see <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status">HTTP response
  *     status codes - HTTP | MDN</a>
@@ -192,8 +243,8 @@ public enum ProblemStatus {
   NOT_MODIFIED(304, "Not Modified"),
 
   /**
-   * @deprecated Obsoleted by RFC 7231. "Use Proxy" is no longer recommended.
    * @link <a href="https://datatracker.ietf.org/doc/html/rfc7231#section-6.4.5">RFC 7231 §6.4.5</a>
+   * @deprecated Obsoleted by RFC 7231. "Use Proxy" is no longer recommended.
    */
   @Deprecated
   USE_PROXY(305, "Use Proxy"),
@@ -320,9 +371,9 @@ public enum ProblemStatus {
   /**
    * 413 Request Entity Too Large.
    *
-   * @link <a href="https://datatracker.ietf.org/doc/html/rfc9110#section-15.5.14">RFC 9110
-   *     §15.5.14</a>
-   * @deprecated Renamed to {@link #CONTENT_TOO_LARGE} by RFC 8297.
+   * @link <a href="https://datatracker.ietf.org/doc/html/rfc2616#section-10.4.14">RFC 2616
+   *     §10.4.14</a>
+   * @deprecated Renamed to {@link #CONTENT_TOO_LARGE} in RFC 9110.
    */
   @Deprecated
   REQUEST_ENTITY_TOO_LARGE(413, "Request Entity Too Large"),
@@ -338,20 +389,20 @@ public enum ProblemStatus {
   /**
    * 414 Request URI Too Long.
    *
-   * @link <a href="https://datatracker.ietf.org/doc/html/rfc9110#section-15.5.15">RFC 9110
-   *     §15.5.15</a>
+   * @link <a href="https://datatracker.ietf.org/doc/html/rfc2616#section-10.4.15">RFC 2616
+   *     §10.4.15</a>
    * @deprecated Renamed to {@link #URI_TOO_LONG} by RFC 8297.
    */
   @Deprecated
-  REQUEST_URI_TOO_LONG(414, "Request URI Too Long"),
+  REQUEST_URI_TOO_LONG(414, "Request-URI Too Long"),
 
   /**
    * 414 URI Too Long.
    *
    * @link <a href="https://datatracker.ietf.org/doc/html/rfc9110#section-15.5.15">RFC 9110
    *     §15.5.15</a>
    */
-  URI_TOO_LONG(414, "Request URI Too Long"),
+  URI_TOO_LONG(414, "URI Too Long"),
 
   /**
    * 415 Unsupported Media Type.
@@ -364,8 +415,8 @@ public enum ProblemStatus {
   /**
    * 416 Requested Range Not Satisfiable.
    *
-   * @link <a href="https://datatracker.ietf.org/doc/html/rfc9110#section-15.5.17">RFC 9110
-   *     §15.5.17</a>
+   * @link <a href="https://datatracker.ietf.org/doc/html/rfc2616#section-10.4.17">RFC 2616
+   *     §10.5.17</a>
    */
   REQUESTED_RANGE_NOT_SATISFIABLE(416, "Requested Range Not Satisfiable"),
 
@@ -520,7 +571,11 @@ public enum ProblemStatus {
    */
   NOT_EXTENDED(510, "Not Extended"),
 
-  /** 511 Network Authentication Required. */
+  /**
+   * 511 Network Authentication Required.
+   *
+   * @link <a href="https://datatracker.ietf.org/doc/html/rfc6585#section-6">RFC 6585 §6</a>
+   */
   NETWORK_AUTHENTICATION_REQUIRED(511, "Network Authentication Required");
 
   /**