Home

Awesome

Gitter Open Source

Hacktoberfest2020

Central repository for FasterXML activities related to Hacktoberfest 2020 by DigitalOcean (https://hacktoberfest.digitalocean.com/).

Contributing

General

All FasterXML projects are participating in Hacktoberfest 2020, so contributions are eligible for the main prizes.

Indeed + Hacktoberfest

In addition to the main event, Indeed.com is sponsoring additional activities -- see Indeed Hacktoberfest 2020 for details -- that can get you additional swag: Jackson is one of OSS projects eligible and supported (being heavily used by Indeed, see Jackson overview at Indeed Engineering Blog).

The only additional requirement is that issues to solve / PRs MUST be labeled with "hacktoberfest" (if such label is missing you may ask maintainers to check if issue should have it).

Contribution Guidelines

Details of making contributions can be found from main Contributing.MD.

Where to add Design (gfx, styles) files?

To allow for easier merging of content contributions, there is folder design/ which is intended as the merging target for contributions: the idea is that you create a sub-folder named same as your Github id, and then you can add all content you want there without risk of merge conflict.

For example, Jackson author would create folder --

design/cowtowncoder

and optionally sub-folders beyond that, if there are multiple files -- to contain his submissions, as part of Pull Request.

This space is not meant as the ultimate target but simply as a simple mechanism to share content outside of Pull Requests, so that merging is easy and merged components can be more easily accessed by community members (for purposes of feedback, and possibly voting for ones they prefer, if there are multiple submissions for same requests).

Good First Issues

Issues for New Contributors page is being updated (more) actively during Hacktoberfest and is a good place to check for issue over Jackson repositories.

Projects specifically looking for help

Although all repositories under FasterXML org in Github are happy to receive contributions (and will qualify for possible prizes and rewards), there are ones that we recommend in particular. Here are some

Jackson Kotlin module

Kotlin module (https://github.com/FasterXML/jackson-module-kotlin) adds support for Kotlin-specific data types, as well as some convenience methods to simplify usage to be more "Kotlin style". Due to Kotlin's rapid development there are sometimes new things to support.

See Issue Tracker for specific issues

Jackson Scala module

Scala module (https://github.com/FasterXML/jackson-module-scala) adds support for Scala-specific data types (such as collection types that do not extend JDK Collections). Main issues are related to making sure that module takes advantage of the latest jackson-databind features.

See Issue Tracker for specific issues

Java 8 date/time datatype module

Issue Tracker (note: there are other Java 8 issues too, but most are Date/Time releated)

Joda date/time datatype module

Issue Tracker

Hibernate datatype module

Hibernate module does currently not have a maintainer and is lagging behind other data type modules, so it would benefit from someone "adopting" it. Jackson team would be happy to find a new owner for it -- but all contributions are welcome. Specific challenges include compatiblity across Hibernate versions (there are actually 3 different modules currently, for Hibernate versions 3.x, 4.x and 5.x+):

Issue Tracker

Bigger / Future Ideas

There is Jackson Future Ideas repository which contains ideas that do not fit into existing projects.

Issue Tracker

Support

Forums

There are a few channels for getting support with Hacktoberfest contributions:

Documentation, Further reading