Skip to content

docs: hygiene sweep — README, SECURITY, CHANGELOG#2

Merged
peo-machine merged 1 commit intomainfrom
docs-hygiene-sweep
Apr 23, 2026
Merged

docs: hygiene sweep — README, SECURITY, CHANGELOG#2
peo-machine merged 1 commit intomainfrom
docs-hygiene-sweep

Conversation

@peo-machine
Copy link
Copy Markdown
Collaborator

Summary

Docs & hygiene bundle for tokencrypt-java, matching the pattern already
shipped in tokencrypt-python (#2, merged) and tokencrypt-rust (#2).

  • README — add badge row (CI + Maven Central + License), reorder Usage
    into the canonical three sections (raw key / Argon2id / legacy-PBKDF2
    explainer), move the JDK / Bouncy Castle prerequisite into the Install
    section, align copy with the other new-language READMEs.
  • SECURITY.md — standard policy pointing at GitHub Private Vulnerability
    Reporting (same file as the other new-language repos).
  • CHANGELOG.md — seeded with the v1.0.0 entry.

Per the 3ncr.org new-language convention
and consistent with the actual source (PR #1 dropped legacy PBKDF2-SHA3),
the third Usage section explains how to recover the legacy key externally
(PKCS5S2ParametersGenerator + SHA3Digest(256)fromRawKey) rather
than documenting a factory that no longer exists. LICENSE stays at 2026
(repo created this year), per §5b.

Test plan

  • CI (Java 11 / 17 / 21 / 25) stays green — docs-only change, no
    source or pom.xml touched.
  • README renders with three working badges on main.

- README: badge row (CI + Maven Central + License), three-section Usage
  reorder (raw key / Argon2id / legacy-PBKDF2 explainer), Install
  section moved above Usage, minor wording alignment with the other
  new-language READMEs.
- SECURITY.md: standard policy pointing at GitHub Private Vulnerability
  Reporting, consistent with tokencrypt-python and tokencrypt-rust.
- CHANGELOG.md: seeded with the v1.0.0 entry.

Per the 3ncr.org new-language convention and consistent with the actual
source (PR #1 dropped legacy PBKDF2-SHA3), the third Usage section
explains how to recover the legacy key externally rather than documenting
a nonexistent factory. LICENSE stays at 2026 (repo created this year).
@peo-machine peo-machine merged commit ed03b9b into main Apr 23, 2026
4 checks passed
@peo-machine peo-machine deleted the docs-hygiene-sweep branch April 23, 2026 03:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants