Deprecate ProblemStatus enum to mark it internal-only (#34)

Author: damianmalczewski

src/main/java/io/github/problem4j/core/AbstractProblemBuilder.java

@@ -126,7 +126,12 @@ public ProblemBuilder status(int status) {
    *
    * @param status the {@link ProblemStatus} representing the HTTP status
    * @return this builder instance for chaining
+   * @deprecated {@link ProblemStatus} will be considered an internal utility of Problem4J Core and
+   *     will be made package-private in a future major release. The decision was made as each HTTP
+   *     framework most likely has its own enum for HTTP status codes, and there's no real value in
+   *     trying to maintain a separate, framework-agnostic enum that mirrors HTTP status codes.
    */
+  @Deprecated
   @Override
   public ProblemBuilder status(@Nullable ProblemStatus status) {
     return status != null ? status(status.getStatus()) : status(0);

src/main/java/io/github/problem4j/core/ProblemBuilder.java

@@ -72,7 +72,12 @@ public interface ProblemBuilder {
    *
    * @param status the {@link ProblemStatus} representing the HTTP status
    * @return this builder instance for chaining
+   * @deprecated {@link ProblemStatus} will be considered an internal utility of Problem4J Core and
+   *     will be made package-private in a future major release. The decision was made as each HTTP
+   *     framework most likely has its own enum for HTTP status codes, and there's no real value in
+   *     trying to maintain a separate, framework-agnostic enum that mirrors HTTP status codes.
    */
+  @Deprecated
   ProblemBuilder status(@Nullable ProblemStatus status);
 
   /**

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

@@ -104,7 +104,12 @@
  * @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>
+ * @deprecated {@link ProblemStatus} will be considered an internal utility of Problem4J Core and
+ *     will be made package-private in a future major release. The decision was made as each HTTP
+ *     framework most likely has its own enum for HTTP status codes, and there's no real value in
+ *     trying to maintain a separate, framework-agnostic enum that mirrors HTTP status codes.
  */
+@Deprecated
 public enum ProblemStatus {
 
   /**