OWASP / OWASP/owasp-java-encoder
Retire or modernize the legacy Maven site and reporting stack
Nobody has claimed this yet.
- Dominant language
- Java
- Stars
- 541
- Forks
- 122
- Avg merge
- 9h 9m
- Merged PRs (30d)
- 1
Description
Follow-up to #90 (reviewed at 31588e1). This tracks work intentionally kept separate from the modernization PR.
Current state
The review found mvn site failing in the legacy Site/Reflow/Doxia stack. The root POM retains Maven Site 3.4, Reflow tools 1.1.1, Velocity 1.7, Doxia Markdown 1.6, and older report plugins including FindBugs.
The reviewed gh-pages branch is a redirect to the OWASP project page, so a maintained source/site publishing requirement should be established before upgrading the entire stack.
Acceptance criteria
- Inventory which generated pages and reports are still consumed, and make an explicit retain-versus-retire decision.
- If retiring: remove unused site/report configuration and dependencies, preserve valuable documentation, and document the canonical OWASP/Javadoc destinations.
- If retaining: update the stack coherently and demonstrate a clean
mvn sitebuild on the supported toolchain. - Review obsolete reports (including FindBugs) and either replace them with maintained analysis or explicitly retire them; coordinate with security CI to avoid redundant tooling.
- Preserve attached sources/Javadocs, release metadata, existing useful links, and ordinary
clean verifybehavior. - Update contributor documentation so it no longer advertises a broken or unused workflow.
Do not delete hosted content or alter the live redirect without a separate maintainer-approved publishing step.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the root POM and the reviewed gh-pages branch, then run mvn site and clean verify on the supported toolchain. Inventory generated pages, reports, dependencies, attached sources/Javadocs, release metadata, and contributor documentation. Done means a documented retain-or-retire decision, preserved useful destinations and behavior, and maintainer-approved handling of hosted content and redirects.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- java
- Domain
- build-system, ci-cd, documentation
- Issue type
- Refactor
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100