Document LambdaBuffers packages (Prelude and Plutus)
Nobody has claimed this yet.
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 45/100
- Issue type
- Documentation
- Clarity
- Mostly clear
- Activity status
- Stale
- Tech stack
- haskell
- Domain
- documentation
Research direction
The requested files are docs/lb-prelude.md and docs/lb-plutus.md. Start by reviewing the Prelude and Plutus package definitions and their opaque, transparent, encoding, equality, and derivation behavior. Done means both package documents specify the listed mappings and semantics in a language-neutral form; no test or other entry point is named.
Written by the indexing model from the issue text.
Description
When implementing runtimes for LB packages (Prelude, Plutus), we need to have a 'language neutral' specification of:
- Which opaques types are listed and what do they map to in different languages.
- How
opaquetypes support a type class- Json encodings
- PlutusData encodings
- Equality
- How
transparenttypes support a type class via derivation- Given a sum/record/prod type how does a Json/PlutusData encoding look like? How is equality performed?
Let's add necessary documentation for this.
I sense that documentation should be associated with an LB package. So it's basically a documentation for the LB package.
- docs/lb-prelude.md
- docs/lb-plutus.md
- Dominant language
- Haskell
- Stars
- 32
- Forks
- 1
- PR merge metrics
- No merged PRs in 30d
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from mlabs-haskell/lambda-buffers
-
Difficulty 4/5 3-5 days Newbie friendliness 25/100
mlabs-haskell/lambda-buffers#296 ·
-
Difficulty 5/5 Over a week Newbie friendliness 20/100
mlabs-haskell/lambda-buffers#295 ·
-
Difficulty 4/5 3-5 days Newbie friendliness 20/100
mlabs-haskell/lambda-buffers#294 ·
-
Dykstra HF Open
Difficulty 4/5 3-5 days Newbie friendliness 35/100
mlabs-haskell/lambda-buffers#293 ·
-
Nix-free path Opendevops
Difficulty 5/5 Over a week Newbie friendliness 25/100
mlabs-haskell/lambda-buffers#292 ·
All issues in mlabs-haskell/lambda-buffers
Similar issues
-
typst-0.12 Open
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
commercialhaskell/stackage#8127 ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
input-output-hk/haskell.nix#2573 ·
-
docs
Difficulty 1/5 Under an hour Newbie friendliness 85/100
-
needs triage type: bug
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100