René's URL Explorer Experiment


Title: Record the decisions on surfaces, JDK-specific tests and imports by abashev · Pull Request #230 · openjavaformat/open-java-format · GitHub

Open Graph Title: Record the decisions on surfaces, JDK-specific tests and imports by abashev · Pull Request #230 · openjavaformat/open-java-format

X Title: Record the decisions on surfaces, JDK-specific tests and imports by abashev · Pull Request #230 · openjavaformat/open-java-format

Description: Four architecture decision records, in docs/decisions/, from the work on #219, #222 and #224. Documentation only; no code changes. Each record is Proposed, and becomes Accepted with this pull request. ADR-001: two entry points, one output for each. Every surface formats a whole file or a part of one. For the same version and input, every surface of an entry gives the same result, and the command line is the reference for whole files. Accepted exceptions for now: the order of fixing imports, Spotless' own step not reflowing long strings, syntax the runtime cannot parse, and a file that does not parse. ADR-002: tests that need a newer JDK, by class and folder. @EnabledForJreRange on the class instead of assumptions inside the tests; case files in test-cases-java21/ and test-cases-java25/, side by side; module imports from JDK 25; value classes gated on the value modifier. ADR-003: imports in IntelliJ IDEA. Reformat never changes imports; Optimize imports does, and the plugin's optimizer is to replace the IDE's through FormatterService.fixImports (#222, after #221). Includes why palantir-java-format dropped its optimizer in 2024. ADR-004: the order of fixing imports stays as it is until #224 decides, with what either order would change. The changes that follow from them come in pull requests of their own.

Open Graph Description: Four architecture decision records, in docs/decisions/, from the work on #219, #222 and #224. Documentation only; no code changes. Each record is Proposed, and becomes Accepted with this pull reque...

X Description: Four architecture decision records, in docs/decisions/, from the work on #219, #222 and #224. Documentation only; no code changes. Each record is Proposed, and becomes Accepted with this pull reque...

Opengraph URL: https://github.com/openjavaformat/open-java-format/pull/230

X: @github

direct link

Domain: github.com

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:9a3343dc-bfd3-ce4d-738f-88af84ac4df1
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idC390:150E61:71F3E:9D402:6AFBC77F
html-safe-nonce993b30f9304b301001132514de83640a98a0c8f49d6c71cc8203344b0016e0ee
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDMzkwOjE1MEU2MTo3MUYzRTo5RDQwMjo2QUZCQzc3RiIsInZpc2l0b3JfaWQiOiI5MDkwNDg1Mzg1NDM5MjAxMTUxIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0=
visitor-hmac1d2db3593f6c5c674df22670ec49931466c3a086e02b8b86213fa97be1feea49
hovercard-subject-tagpull_request:5315821484
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/openjavaformat/open-java-format/pull/230/files
twitter:imagehttps://avatars.githubusercontent.com/u/214171?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/214171?s=400&v=4
og:image:altFour architecture decision records, in docs/decisions/, from the work on #219, #222 and #224. Documentation only; no code changes. Each record is Proposed, and becomes Accepted with this pull reque...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
Noned440bda0d812801778b27bfe9f7c1ce9ff22420c73f6f95150c4fcbca311c50b
turbo-cache-controlno-preview
diff-viewunified
go-importgithub.com/openjavaformat/open-java-format git https://github.com/openjavaformat/open-java-format.git
octolytics-dimension-user_id325177626
octolytics-dimension-user_loginopenjavaformat
octolytics-dimension-repository_id1288055459
octolytics-dimension-repository_nwoopenjavaformat/open-java-format
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forktrue
octolytics-dimension-repository_parent_id214273098
octolytics-dimension-repository_parent_nwopalantir/palantir-java-format
octolytics-dimension-repository_network_root_id214273098
octolytics-dimension-repository_network_root_nwopalantir/palantir-java-format
turbo-body-classeslogged-out env-production page-responsive full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release2c43021aed8695990c86c0eaaedc600bfeffec36
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/openjavaformat/open-java-format/pull/230/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenjavaformat%2Fopen-java-format%2Fpull%2F230%2Ffiles
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenjavaformat%2Fopen-java-format%2Fpull%2F230%2Ffiles
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=openjavaformat%2Fopen-java-format
Reloadhttps://github.com/openjavaformat/open-java-format/pull/230/files
Reloadhttps://github.com/openjavaformat/open-java-format/pull/230/files
Reloadhttps://github.com/openjavaformat/open-java-format/pull/230/files
openjavaformathttps://github.com/openjavaformat
open-java-formathttps://github.com/openjavaformat/open-java-format
Codehttps://github.com/openjavaformat/open-java-format
Issues30 (30)https://github.com/openjavaformat/open-java-format/issues
Pull requests5 (5)https://github.com/openjavaformat/open-java-format/pulls
Discussionshttps://github.com/openjavaformat/open-java-format/discussions
Actionshttps://github.com/openjavaformat/open-java-format/actions
Security and qualityhttps://github.com/openjavaformat/open-java-format/security
Insightshttps://github.com/openjavaformat/open-java-format/pulse
Sign up for GitHub https://github.com/signup?return_to=%2Fopenjavaformat%2Fopen-java-format%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fopenjavaformat%2Fopen-java-format%2Fissues%2Fnew%2Fchoose
abashevhttps://github.com/abashev
21.X.Xhttps://github.com/openjavaformat/open-java-format/tree/21.X.X
abashev/Architecture-decision-recordshttps://github.com/openjavaformat/open-java-format/tree/abashev/Architecture-decision-records
Conversation 0 https://github.com/openjavaformat/open-java-format/pull/230
Commits 9 https://github.com/openjavaformat/open-java-format/pull/230/commits
Checks 17 https://github.com/openjavaformat/open-java-format/pull/230/checks
Files changed https://github.com/openjavaformat/open-java-format/pull/230/files
Please reload this pagehttps://github.com/openjavaformat/open-java-format/pull/230/files
Record the decisions on surfaces, JDK-specific tests and imports https://github.com/openjavaformat/open-java-format/pull/230/files#top
Show all changes 9 commits https://github.com/openjavaformat/open-java-format/pull/230/files
e00ad49 Record ADR-001: two entry points, one output for each abashev Nov 14, 2026 https://github.com/openjavaformat/open-java-format/pull/230/commits/e00ad498816f2f568a1cf4bb8aea3282581a1876
dabbe92 Record ADR-002: tests that need a newer JDK, by class and folder abashev Nov 14, 2026 https://github.com/openjavaformat/open-java-format/pull/230/commits/dabbe92ffd8d9552db96b7da7de6f8f3690d4fdc
c058a20 Record ADR-003: imports in IntelliJ IDEA abashev Nov 14, 2026 https://github.com/openjavaformat/open-java-format/pull/230/commits/c058a20387117249860adbfd19fe199850516bef
c672f3a Record ADR-004: the order of fixing imports stays as it is abashev Nov 14, 2026 https://github.com/openjavaformat/open-java-format/pull/230/commits/c672f3aa2e309fc47db58e263ab592827226410e
b56e4b9 ADR-002: value classes from JDK 28, with a case folder of their own abashev Nov 14, 2026 https://github.com/openjavaformat/open-java-format/pull/230/commits/b56e4b9d4d122734e40806a2a5ed2eced002734c
f151596 ADR-002: one class per JDK for the case folders, JDK 21 too abashev Nov 14, 2026 https://github.com/openjavaformat/open-java-format/pull/230/commits/f151596182c663aa4b4d8fd5bf5fd5c24415636c
f8d0549 ADR-002: the newest case folder first abashev Nov 15, 2026 https://github.com/openjavaformat/open-java-format/pull/230/commits/f8d0549db5a5a6eef6459b32ba0e6bf98b08f56d
2e1cc96 ADR-002: each JDK's cases from that JDK on, with no upper bound abashev Nov 15, 2026 https://github.com/openjavaformat/open-java-format/pull/230/commits/2e1cc9697b7227f8a4d63b98cc23bcc3c1b42d37
d81cbbb Merge remote-tracking branch 'origin/21.X.X' into abashev/Architectur… abashev Nov 15, 2026 https://github.com/openjavaformat/open-java-format/pull/230/commits/d81cbbb08432a1576a87be95230c59f131a88a4e
Clear filters https://github.com/openjavaformat/open-java-format/pull/230/files
Please reload this pagehttps://github.com/openjavaformat/open-java-format/pull/230/files
Please reload this pagehttps://github.com/openjavaformat/open-java-format/pull/230/files
ADR-001-one-output-per-entry-point.md https://github.com/openjavaformat/open-java-format/pull/230/files#diff-d872c6d456fbadf75453c2f1fb387ea9a13b796f03b48570b251ea1e4c65bb59
ADR-002-tests-by-jdk.md https://github.com/openjavaformat/open-java-format/pull/230/files#diff-a92aaa8bc9f769683934ad4496428fcd72f734e66a8522b82c26eacd34a27681
ADR-003-imports-in-intellij-idea.md https://github.com/openjavaformat/open-java-format/pull/230/files#diff-d9899472e7a75f6b0040e0a285f6030e9dd0950aa25230c6ee720f5d494581af
ADR-004-order-of-fixing-imports.md https://github.com/openjavaformat/open-java-format/pull/230/files#diff-98c8b22fde829c560e9b81806eec7d8d056b0894dcb0ec67f2922d8c0513a5cb
docs/decisions/ADR-001-one-output-per-entry-point.mdhttps://github.com/openjavaformat/open-java-format/pull/230/files#diff-d872c6d456fbadf75453c2f1fb387ea9a13b796f03b48570b251ea1e4c65bb59
View file https://github.com/openjavaformat/open-java-format/blob/d81cbbb08432a1576a87be95230c59f131a88a4e/docs/decisions/ADR-001-one-output-per-entry-point.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/openjavaformat/open-java-format/pull/230/{{ revealButtonHref }}
docs/decisions/ADR-002-tests-by-jdk.mdhttps://github.com/openjavaformat/open-java-format/pull/230/files#diff-a92aaa8bc9f769683934ad4496428fcd72f734e66a8522b82c26eacd34a27681
View file https://github.com/openjavaformat/open-java-format/blob/d81cbbb08432a1576a87be95230c59f131a88a4e/docs/decisions/ADR-002-tests-by-jdk.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/openjavaformat/open-java-format/pull/230/{{ revealButtonHref }}
docs/decisions/ADR-003-imports-in-intellij-idea.mdhttps://github.com/openjavaformat/open-java-format/pull/230/files#diff-d9899472e7a75f6b0040e0a285f6030e9dd0950aa25230c6ee720f5d494581af
View file https://github.com/openjavaformat/open-java-format/blob/d81cbbb08432a1576a87be95230c59f131a88a4e/docs/decisions/ADR-003-imports-in-intellij-idea.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/openjavaformat/open-java-format/pull/230/{{ revealButtonHref }}
Please reload this pagehttps://github.com/openjavaformat/open-java-format/pull/230/files
Please reload this pagehttps://github.com/openjavaformat/open-java-format/pull/230/files
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.