Skip to content

Add JHarmonizer into the README as a third-party integration#1661

Open
AntonLem wants to merge 5 commits into
palantir:developfrom
AntonLem:docs/add-jharmonizer-integration
Open

Add JHarmonizer into the README as a third-party integration#1661
AntonLem wants to merge 5 commits into
palantir:developfrom
AntonLem:docs/add-jharmonizer-integration

Conversation

@AntonLem
Copy link
Copy Markdown

@AntonLem AntonLem commented May 8, 2026

Before this PR

The README lists several ways to use palantir-java-format, including IDE plugins, Gradle usage, and Spotless integration.

However, it does not mention downstream tools that build on top of palantir-java-format for broader Java source harmonization workflows.

After this PR

Document JHarmonizer as a third-party integration.

JHarmonizer is an open-source Maven plugin and standalone CLI that performs deterministic Java class member reordering and then delegates final formatting and import cleanup to palantir-java-format.

This makes it easier for users who need both structural source ordering and Palantir-style formatting to discover an existing integration path.

Possible downsides?

This adds a link to a third-party project that is not maintained by Palantir.

* docs: add Chronizer third-party CLI and Maven plugin section to README

Agent-Logs-Url: https://github.com/AntonLem/palantir-java-format/sessions/0318bb9c-4bfd-4240-8f79-210241fb953c

Co-authored-by: AntonLem <2189039+AntonLem@users.noreply.github.com>

* docs: rename Chronizer to JHarmonizer with correct repo URL

Agent-Logs-Url: https://github.com/AntonLem/palantir-java-format/sessions/83e582a9-11d5-4216-bf57-fcb6f0454a50

Co-authored-by: AntonLem <2189039+AntonLem@users.noreply.github.com>

* docs: fix JHarmonizer disclaimer formatting and add tool description

Agent-Logs-Url: https://github.com/AntonLem/palantir-java-format/sessions/eae918ee-76ac-48ad-9c16-f25fe041dbe5

Co-authored-by: AntonLem <2189039+AntonLem@users.noreply.github.com>

* docs: improve JHarmonizer description with plain language and three-mode overview

Agent-Logs-Url: https://github.com/AntonLem/palantir-java-format/sessions/1b63a56b-b721-4573-8dd8-19fe4738fac4

Co-authored-by: AntonLem <2189039+AntonLem@users.noreply.github.com>

* docs: remove third-party label, disclaimer, and git hooks bullet from JHarmonizer section

Agent-Logs-Url: https://github.com/AntonLem/palantir-java-format/sessions/0c55b41b-d4e0-4016-a4a5-55faee616749

Co-authored-by: AntonLem <2189039+AntonLem@users.noreply.github.com>

* docs: fix "three modes" -> "two modes" after removing git hooks bullet

Agent-Logs-Url: https://github.com/AntonLem/palantir-java-format/sessions/ab96fb6d-11bc-485d-96c0-1d3a4c6ed0bf

Co-authored-by: AntonLem <2189039+AntonLem@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: AntonLem <2189039+AntonLem@users.noreply.github.com>
Copilot AI review requested due to automatic review settings May 8, 2026 23:04
@changelog-app
Copy link
Copy Markdown

changelog-app Bot commented May 8, 2026

Generate changelog in changelog/@unreleased

Type (Select exactly one)

  • Feature (Adding new functionality)
  • Improvement (Improving existing functionality)
  • Fix (Fixing an issue with existing functionality)
  • Break (Creating a new major version by breaking public APIs)
  • Deprecation (Removing functionality in a non-breaking way)
  • Migration (Automatically moving data/functionality to a new system)

Description

Add JHarmonizer into the README as a third-party integration

Check the box to generate changelog(s)

  • Generate changelog entry

@palantirtech
Copy link
Copy Markdown
Member

Thanks for your interest in palantir/palantir-java-format, @AntonLem! Before we can accept your pull request, you need to sign our contributor license agreement - just visit https://cla.palantir.com/ and follow the instructions. Once you sign, I'll automatically update this pull request.

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds documentation for JHarmonizer as a third-party integration that combines deterministic Java member reordering with palantir-java-format formatting, making it easier for users to discover an end-to-end “reorder + format” workflow.

Changes:

  • Add JHarmonizer to the README table of contents.
  • Introduce a new “## JHarmonizer” section describing features, modes, and distribution options.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
Comment thread README.md Outdated
AntonLem and others added 2 commits May 9, 2026 01:13
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
…on (#3)

* Add community-supported disclaimer to README after header

Agent-Logs-Url: https://github.com/AntonLem/palantir-java-format/sessions/6fef1970-2885-4d41-9dc3-9ac4d671f148

Co-authored-by: AntonLem <2189039+AntonLem@users.noreply.github.com>

* Move disclaimer from main heading to JHarmonizer section

Agent-Logs-Url: https://github.com/AntonLem/palantir-java-format/sessions/6113d28f-5f4e-431b-8aa5-983ca23e81a2

Co-authored-by: AntonLem <2189039+AntonLem@users.noreply.github.com>

* Remove 'Disclaimer' label from JHarmonizer blockquote

Agent-Logs-Url: https://github.com/AntonLem/palantir-java-format/sessions/7b1ee65c-e082-4c82-b0da-777fa22196a1

Co-authored-by: AntonLem <2189039+AntonLem@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: AntonLem <2189039+AntonLem@users.noreply.github.com>
Copilot AI added a commit to AntonLem/palantir-java-format that referenced this pull request May 9, 2026
Copilot AI and others added 2 commits May 9, 2026 10:36
* Add changelog entry for JHarmonizer README integration

Agent-Logs-Url: https://github.com/AntonLem/palantir-java-format/sessions/199d7d33-527a-47eb-88f8-d396d3b7fc56

Co-authored-by: AntonLem <2189039+AntonLem@users.noreply.github.com>

* Update changelog link to upstream PR palantir#1661

Agent-Logs-Url: https://github.com/AntonLem/palantir-java-format/sessions/c664dcf3-7c62-4138-9429-da1575c6eba2

Co-authored-by: AntonLem <2189039+AntonLem@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: AntonLem <2189039+AntonLem@users.noreply.github.com>
Agent-Logs-Url: https://github.com/AntonLem/palantir-java-format/sessions/9c93b224-887e-4fe0-811f-ded9eccdb1d6

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: AntonLem <2189039+AntonLem@users.noreply.github.com>
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.

4 participants