Path to Jackson 3.0.0

[cowtowncoder]

Goal of this Discussion

This Discussion is "uber-discussion" covering the high-level scope of what the official Jackson 3.0.0 Release should include, along with bit of status of the progress. Most of content will be links to other pages, issues, discussions in other repos (with actual Issues, for example).

Note that while most issues are hoped to be addressed by 3.0.0-rc1 (the first pre-release), we may want to stage them across multiple RCs to follow "release early, release often" to get a tight feedback loop.

Jackson 3.0.0: Requirements

To reach state where we are ready to publish the final 3.0.0, we have to tackle following things.
(note: this document is work-in-progress and will continue living -- it is not a static requirements document).

JSTEPs

See JSTEP Overview for an overview what JSTEPs are. They can be thought as an effort bigger than what a single Issue can cover, and are natural way to group such efforts.

For 3.0.0 we want to tackle most of them, specifically:

JSTEP	Description	Status
JSTEP-1	Maven artifact, Java package name change (Jackson 2.x -> 3.x)	mostly complete
JSTEP-2	Jackson 3.0 Default Settings	in-progress
JSTEP-3	JsonNode improvements	in-progress
JSTEP-4	Unchecked JacksonException	complete
JSTEP-5	Unified/improved Data/Time handling	proposed
JSTEP-6	Jackson 3.0 Renaming of Entities	mostly complete
JSTEP-8	Jackson 3.0 Renaming of Format-specific Features	complete
JSTEP-9	Jackson 3.0 Removal of Deprecated 2.x Modules	initial discussion

Note that we can create new JTEPs and reconsider ones not completed. Some JSTEPs are also for 2.x, not 3.0 (and others for later 3.x versions beyond initial one).

Things to decide (polls!)

Here are things to decide on proposed changes: please vote if you have opinion on whether change suggested is desired.

You may also add comments explaining your reasoning, as well as upvote comments by others.

General

• Minimum Java Version for 3.0.0 (17 vs 21) (databind#4820)
• Deprecate+remove Hibernate modules from 3.0.0

Changes to Feature defaults

• Poll Default for 'DeserializationFeature.FAIL_ON_TRAILING_TOKENS' -- issue: databind#3406
• Poll Default for 'MapperFeature.DEFAULT_VIEW_INCLUSION' -- issue: databind#1484
• Poll Default for 'SerializationFeature.WRITE_DATES_AS_TIMESTAMPS' -- issue: databind#4845
• Poll Default for 'SerializationFeature.WRITE_DURATIONS_AS_TIMESTAMPS' -- issue: databind#4846

Issues to work on in jackson-databind

Aside from decisions (or in some cases, related to), there are specific issues to work on.

"Most Wanted" Jackson issues

Of all open issues, a small subset has been labeled as "most-wanted" based on upvotes.
These may be considered for inclusion in 2.x as well, but some might require bigger changes.
Because of this, it would make sense to see if any could be added in 3.0.0-SNAPSHOT:

• https://github.com/FasterXML/jackson-databind/issues?q=is%3Aissue+is%3Aopen+label%3Amost-wanted+

Issues labeled with '3.0'

Some issues have been labeled specifically as targeted to 3.0.0-SNAPSHOT release:

https://github.com/FasterXML/jackson-databind/issues?q=is%3Aissue+is%3Aopen+label%3A3.0

Issues labeled with '3.x'

Other issues have been labeled with 3.x to indicate "not possible/practical for 2.x, maybe one of 3.x releases", but not necessarily 3.0.0:

https://github.com/FasterXML/jackson-databind/issues?q=is%3Aissue+is%3Aopen+label%3A3.x

Issues/Discussion for Other Modules

Beside jackson-databind repo, there are issues in other FasterXML Jackson repositories, labeled for ideally being included in 3.0.0-SNAPSHOT:

[TO BE ADDED]

[cowtowncoder]

/cc @k163377 @pjfanning @yawkat @yihtserns -- the new central planning page for Jackson 3.0.0. Trying to collect links to everything pertinent, keep updated. Especially interested in 3 Polls under "Things to Decide".

[JooHyukKim]

I should go tell community in Korea to vote. There is huge Java community here.