Migration (#51)

* Bump actions/github-script from 6 to 8

Bumps [actions/github-script](https://github.com/actions/github-script) from 6 to 8.
- [Release notes](https://github.com/actions/github-script/releases)
- [Commits](actions/github-script@v6...v8)

---
updated-dependencies:
- dependency-name: actions/github-script
  dependency-version: '8'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <[email protected]>

* Change settings.gradle

* update gradle wrapper

* change group var in build.gradle

* change gitHub URL in publishing.gradle

* enhance minimum test coverage from 85-90

* change package name

* change und misc.xml change for idea

* fix strange refactor artefacts in markdown code blocks

* fix strange refactor artefacts in markdown code blocks part 2

* CODE_OF_CONDUCT.md

* docs: CONTRIBUTING.md

* Update readme for the gitHub Action

* Update build workflow

* Update release workflow

* adding ci step for specs validation

* JTOON

* JTOON

* JTOON renmame in README.md

* JTOON renmame in README.md

* Update publishing.gradle

* Update repository links in CONTRIBUTING.md and README.md to reflect new GitHub organization

* Update documentation: Add new contributors, enhance contribution guidelines, and clarify project status in README.md, CHANGELOG.md, and LICENSE.md

* Update README.md to reflect new Maven Central group ID and enhance documentation structure; add FORMAT.md for TOON format specification and documentation/README.md for API details.

* Add Javadoc generation task to build.gradle for HTML documentation

* Enhance Javadoc comments across multiple classes to improve documentation clarity, including detailed parameter and return descriptions for methods in DecodeOptions, EncodeOptions, ArrayEncoder, ObjectEncoder, and others.

* Creates project Javadoc

* Moves documentation folder to docs

* Update README and docs/README to correct Javadoc links for improved accessibility

* Add project name to .idea configuration and update JDK version to 17 in misc.xml

* docs: harmonize issue templates, contributing guide, readme, etc. with other repos

* Update repository links and documentation references to reflect project renaming from JToon to toon-java

* Update Javadoc package summary and improve documentation links for consistency and clarity

* Update README to correct Javadoc link and enhance table formatting for better readability

* Fixes migration details

---------

Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Jens Papenhagen <[email protected]>
Co-authored-by: GiovanniCaggianella <[email protected]>
Co-authored-by: Johann Schopplich <[email protected]>

Author: 5 people

.github/CODEOWNERS

@@ -0,0 +1,6 @@
+# Default owners for everything
+* @toon-format/java-maintainers
+
+# Project governance and documentation
+CODE_OF_CONDUCT.md @johannschopplich
+CONTRIBUTING.md @felipestanzani

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,67 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug!
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear description of what the bug is
+      placeholder: When I try to encode..., I expect..., but instead...
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction Steps
+      description: Steps to reproduce the behavior
+      placeholder: |
+        1. Create a Toon instance
+        2. Call encode() with...
+        3. See error...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What you expected to happen
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened (including error messages and stack traces)
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: |
+        Please provide:
+        - Java version
+        - JToon version (from build.gradle or pom.xml)
+        - Operating system
+      placeholder: |
+        - Java 21.0.1
+        - JToon 0.1.2
+        - macOS 15.0
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other context about the problem (optional)

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,48 @@
+name: Feature Request
+description: Suggest a new feature or enhancement
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a feature!
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: What problem does this feature solve?
+      placeholder: As a user, I want to... because...
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: How would you like this to work?
+      placeholder: |
+        Add a new method/function that...
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: What alternative solutions have you considered?
+
+  - type: textarea
+    id: spec
+    attributes:
+      label: SPEC Compliance
+      description: |
+        Does this relate to the TOON specification?
+        If yes, please reference the relevant section.
+      placeholder: This relates to SPEC.md section...
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other context, mockups, or examples

.github/ISSUE_TEMPLATE/spec_compliance.yml

@@ -0,0 +1,65 @@
+name: SPEC Compliance Issue
+description: Report a deviation from the TOON specification
+labels: ["spec-compliance"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Report an issue where JToon doesn't comply with the official TOON spec.
+
+  - type: input
+    id: spec-version
+    attributes:
+      label: SPEC Version
+      description: Which version of the TOON spec does this relate to?
+      placeholder: v1.3
+    validations:
+      required: true
+
+  - type: input
+    id: spec-section
+    attributes:
+      label: SPEC Section
+      description: Which section of SPEC.md is affected?
+      placeholder: "Section 2.3: Array Notation"
+    validations:
+      required: true
+
+  - type: textarea
+    id: spec-requirement
+    attributes:
+      label: SPEC Requirement
+      description: What does the spec require?
+      placeholder: According to SPEC.md, the encoder should...
+    validations:
+      required: true
+
+  - type: textarea
+    id: current-behavior
+    attributes:
+      label: Current Behavior
+      description: What does JToon currently do?
+      placeholder: Currently, JToon...
+    validations:
+      required: true
+
+  - type: textarea
+    id: test-case
+    attributes:
+      label: Test Case
+      description: Provide a test case that demonstrates the issue
+      placeholder: |
+        ```java
+        import com.felipestanzani.toon.Toon;
+        String result = Toon.encode(...);
+        // Expected: ...
+        // Actual: ...
+        ```
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other relevant information

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,121 @@
+## Description
+
+<!-- Provide a clear and concise description of your changes -->
+
+## Type of Change
+
+<!-- Mark the relevant option with an [x] -->
+
+- [ ] Bug fix (non-breaking change that fixes an issue)
+- [ ] New feature (non-breaking change that adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Refactoring (no functional changes)
+- [ ] Performance improvement
+- [ ] Test coverage improvement
+
+## Related Issues
+
+<!-- Link any related issues using #issue_number -->
+
+Closes #
+
+## Changes Made
+
+<!-- List the main changes in this PR -->
+
+-
+-
+-
+
+## SPEC Compliance
+
+<!-- If this PR relates to the TOON spec, indicate which sections are affected -->
+
+- [ ] This PR implements/fixes spec compliance
+- [ ] Spec section(s) affected:
+- [ ] Spec version:
+
+## Testing
+
+<!-- Describe the tests you added or ran -->
+
+- [ ] All existing tests pass
+- [ ] Added new tests for changes
+- [ ] Tested on Java 17
+- [ ] Tested on Java 21
+
+### Test Output
+
+```bash
+# Paste test output here
+```
+
+## Code Quality
+
+<!-- Confirm code quality checks -->
+
+- [ ] Ran `./gradlew test` - all tests pass
+- [ ] Ran `./gradlew jacocoTestCoverageVerification` - coverage meets 85% threshold
+- [ ] Added JavaDoc comments for public APIs
+- [ ] Code follows Java conventions
+
+## Checklist
+
+<!-- Mark completed items with an [x] -->
+
+- [ ] My code follows the project's coding standards
+- [ ] I have added JavaDoc comments to new public APIs
+- [ ] I have added JUnit tests that prove my fix/feature works
+- [ ] New and existing tests pass locally
+- [ ] I have updated documentation (README.md if needed)
+- [ ] My changes do not introduce new dependencies (or are justified)
+- [ ] I have maintained Java 17+ compatibility
+- [ ] I have reviewed the [TOON specification](https://github.com/toon-format/spec) for relevant sections
+
+## Performance Impact
+
+<!-- If applicable, describe any performance implications -->
+
+- [ ] No performance impact
+- [ ] Performance improvement (describe below)
+- [ ] Potential performance regression (describe and justify below)
+
+<!-- Details: -->
+
+## Breaking Changes
+
+<!-- If this is a breaking change, describe the migration path for users -->
+
+- [ ] No breaking changes
+- [ ] Breaking changes (describe migration path below)
+
+<!-- Migration path: -->
+
+## Screenshots / Examples
+
+<!-- If applicable, add screenshots or example output -->
+
+```java
+// Example usage
+```
+
+Output:
+```
+# Example output
+```
+
+## Additional Context
+
+<!-- Add any other context about the PR here (optional) -->
+
+## Checklist for Reviewers
+
+<!-- For maintainers reviewing this PR -->
+
+- [ ] Code changes are clear and well-documented
+- [ ] Tests adequately cover the changes
+- [ ] Documentation is updated
+- [ ] No security concerns
+- [ ] Follows TOON specification
+- [ ] Backward compatible (or breaking changes are justified and documented)

.github/RELEASE.md

@@ -30,12 +30,12 @@ The project uses GitHub Actions to automatically build and release when a versio
    ```
 
 4. **Wait for the workflow to complete**
-   - The GitHub Actions workflow will automatically:
-     - Build the project
-     - Run all tests
-     - Create a GitHub release
-     - Attach the JAR file to the release
-     - Generate release notes from commits
+    - The GitHub Actions workflow will automatically:
+        - Build the project
+        - Run all tests
+        - Create a GitHub release
+        - Attach the JAR file to the release
+        - Generate release notes from commits
 
 ### Release Artifacts
 
@@ -46,7 +46,8 @@ The release will include:
 
 ### Pre-release Versions
 
-If your version contains a dash (e.g., `1.0-SNAPSHOT`, `2.0-beta`), the release will be marked as a pre-release automatically.
+If your version contains a dash (e.g., `1.0-SNAPSHOT`, `2.0-beta`), 
+the release will be marked as a pre-release automatically.
 
 ### Version Tag Format
 
@@ -59,7 +60,8 @@ Use semantic versioning with a `v` prefix:
 
 ## Continuous Integration
 
-Every push to `main`, `master`, or `develop` branches, and every pull request, triggers the build workflow which:
+Every push to `main`, `master`, or `develop` branches, and every pull request, 
+triggers the build workflow which:
 
 - Compiles the code
 - Runs all tests

.github/workflows/build.yml

@@ -22,10 +22,10 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v5
+        uses: actions/checkout@v5.0.0
 
       - name: Set up JDK 21
-        uses: actions/setup-java@v5
+        uses: actions/setup-java@v5.0.0
         with:
           java-version: '21'
           distribution: 'temurin'
@@ -38,7 +38,7 @@ jobs:
         run: ./gradlew build
 
       - name: Upload test results
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v5.0.0
         if: always()
         with:
           name: test-results
@@ -58,15 +58,14 @@ jobs:
 
       - name: Fail PR if overall coverage is less than 85%
         if: ${{ steps.jacoco.outputs.coverage-overall < 85.0 }}
-        uses: actions/github-script@v6
+        uses: actions/github-script@v8
         with:
           script: |
             core.setFailed('Overall coverage is less than 85%!')
 
       - name: Upload build artifacts
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v5.0.0
         with:
           name: build-artifacts
           path: build/libs/*.jar
           retention-days: 7
-