haskell/aeson

Migration guide 1.5 -> 2.0

Open

#881 opened on Oct 11, 2021

View on GitHub
 (13 comments) (4 reactions) (0 assignees)Haskell (1,298 stars) (334 forks)batch import
help wanted

Description

The changelog isn't explicit about how to migrate from aeson-1.5 to -2.0. Please add a migration guide with the most common fixes needed.

Contributor guide

Tech stack
None
Domain
documentation
Issue type
documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Familiarity with aeson APIUnderstanding of version differences
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
60
Research direction
Examine the aeson repository's CHANGELOG and release notes for version 2.0. Identify common patterns in closed issues or PRs that required migration fixes. Draft a guide covering the most frequent changes.
Migration guide 1.5 -> 2.0 · haskell/aeson#881 | Good First Issue