2019-01-20 04:08:56 +03:00
# Contributor Guide
2019-01-20 02:27:44 +03:00
2021-07-24 08:07:09 +03:00
< div class = pagetoc >
2021-05-07 05:00:18 +03:00
<!-- toc -->
2021-07-24 08:07:09 +03:00
< / div >
2021-05-07 05:00:18 +03:00
2021-09-27 15:00:30 +03:00
This doc is intended to become a focussed guide for new contributors.
2021-09-27 14:44:14 +03:00
If you are unexpectedly seeing this page after following a link,
the content probably moved to a separate page:
see the [Developer docs ](dev.md ).
2021-09-27 14:17:18 +03:00
2019-01-20 02:27:44 +03:00
## Quick Links
| | |
2020-03-06 20:49:26 +03:00
|-------------------------------|----------------------------------------------------------------------------
2021-09-20 21:20:19 +03:00
| Chat, Mail, Twitter, HN etc. | < https: / / hledger . org / # help >
2021-09-20 21:23:11 +03:00
| hledger-web demo | [demo.hledger.org ](https://demo.hledger.org )
2021-09-20 21:20:19 +03:00
| hledger GHCJS demo | < https: / / hledger . alhur . es >
2021-09-20 21:23:11 +03:00
| Trello | [old wishlist planning board ](https://trello.hledger.org )
| Github | [simonmichael/hledger ](https://github.com/simonmichael/hledger ) (shortcut: code.hledger.org)< br > [commits ](https://github.com/simonmichael/hledger/commits ), <!-- [unreleased commits ](https://github.com/simonmichael/hledger/compare/0.23...master ), [release branch commits ](https://github.com/simonmichael/hledger/compare/master...0.23 ), --> [COMMITS! ](https://starlogs.net/#simonmichael/hledger ) < br > [open bugs ](http://bugs.hledger.org ), [open wishes ](http://wishes.hledger.org ), [open unknowns ](https://github.com/simonmichael/hledger/issues?utf8=✓&q=is%3Aissue%20is%3Aopen%20-label%3A%22A%20BUG%22%20-label%3A%22A%20WISH%22%20 ), [open pull requests ](http://prs.hledger.org ), [draft open pull requests ](http://draftprs.hledger.org ), [ready open pull requests ](http://readyprs.hledger.org ), [all issues ](https://github.com/simonmichael/hledger/issues?q= ) < br > [issues with bounty tag ](https://github.com/simonmichael/hledger/issues?q=label:bounty ), [bountysource bounties ](https://github.com/simonmichael/hledger/issues?q=%22Add%20to%20the%20bounty%20at%20Bountysource%22%20OR%20%22claim%20the%20bounty%20on%20Bountysource%22%20OR%20%22bounty%20on%20this%20issue%20has%20been%20claimed%20at%20Bountysource%22%20 ), [codemill bounties ](https://github.com/simonmichael/hledger/issues?q=codemill ), [codefund bounties ](https://github.com/simonmichael/hledger/issues?utf8=✓&q=codefund ) < br > [stars.hledger.org ](http://stars.hledger.org ): < a class = "github-button" href = "https://github.com/simonmichael/hledger" data-icon = "octicon-star" data-count-href = "/simonmichael/hledger/stargazers" data-count-api = "/repos/simonmichael/hledger#stargazers_count" data-count-aria-label = "# stargazers on GitHub" aria-label = "Star simonmichael/hledger on GitHub" ></ a > our rank among starred haskell projects:< br > 2016: #71 , 2017: #54 , 2018: #53 , 2020: #36 < br > [github projects ](https://github.com/simonmichael/hledger/projects ) < br > [ci.hledger.org ](http://ci.hledger.org ) [![hledger CI ](https://github.com/simonmichael/hledger/workflows/hledger%20CI/badge.svg )](https://github.com/simonmichael/hledger/actions)
| Hackage | < a name = hackage ></ a > packages: [hledger-lib ](https://hackage.haskell.org/package/hledger-lib ), [hledger ](https://hackage.haskell.org/package/hledger ), [hledger-ui ](https://hackage.haskell.org/package/hledger-ui ), [hledger-web ](https://hackage.haskell.org/package/hledger-web ), [hledger-diff ](https://hackage.haskell.org/package/hledger-diff ), [hledger-iadd ](https://hackage.haskell.org/package/hledger-iadd ), [hledger-interest ](https://hackage.haskell.org/package/hledger-interest ), [hledger-irr ](https://hackage.haskell.org/package/hledger-irr ), [\*hledger\* ](https://hackage.haskell.org/packages/search?terms=hledger ) <!-- [![... ](https://img.shields.io/hackage/v/hledger.svg?label=current+release )](https://hackage.haskell.org/package/hledger) --> < br > diffs: [hledger-lib ](https://hdiff.luite.com/cgit/hledger-lib/diff ), [hledger ](https://hdiff.luite.com/cgit/hledger/diff ), [hledger-ui ](https://hdiff.luite.com/cgit/hledger-ui/diff ), [hledger-web ](https://hdiff.luite.com/cgit/hledger-web/diff ) < br > build status: [hledger-lib ](https://matrix.hackage.haskell.org/package/hledger-lib ), [hledger ](https://matrix.hackage.haskell.org/package/hledger ), [hledger-ui ](https://matrix.hackage.haskell.org/package/hledger-ui ), [hledger-web ](https://matrix.hackage.haskell.org/package/hledger-web ) < br > reverse deps: [hledger-lib ](https://packdeps.haskellers.com/reverse/hledger-lib ), [hledger ](https://packdeps.haskellers.com/reverse/hledger ), [hledger-ui ](https://packdeps.haskellers.com/reverse/hledger-ui ), [hledger-web ](https://packdeps.haskellers.com/reverse/hledger-web ) < br > [![on hackage ](https://img.shields.io/hackage/v/hledger.svg?label=hackage&colorB=green )](https://hackage.haskell.org/package/hledger) < br > [![... ](https://img.shields.io/hackage-deps/v/hledger-lib.svg?label=hledger-lib+bounds )](https://packdeps.haskellers.com/feed?needle=hledger-lib) [![... ](https://img.shields.io/hackage-deps/v/hledger.svg?label=hledger+bounds )](https://packdeps.haskellers.com/feed?needle=hledger) < br > [![... ](https://img.shields.io/hackage-deps/v/hledger-ui.svg?label=hledger-ui+bounds )](https://packdeps.haskellers.com/feed?needle=hledger-ui) [![... ](https://img.shields.io/hackage-deps/v/hledger-web.svg?label=hledger-web+bounds )](https://packdeps.haskellers.com/feed?needle=hledger-web)
2021-05-07 05:00:18 +03:00
| Stackage | [build-constraints.yaml ](https://github.com/fpco/stackage/blob/master/build-constraints.yaml ) < br > [open hledger-related issues ](https://github.com/fpco/stackage/search?q=hledger+is%3Aopen&type=Issues ) < br > packages: [hledger-lib ](https://www.stackage.org/package/hledger-lib ), [hledger ](https://www.stackage.org/package/hledger ), [hledger-ui ](https://www.stackage.org/package/hledger-ui ), [hledger-web ](https://www.stackage.org/package/hledger-web )< br > versions: [hledger-lib ](https://www.stackage.org/package/hledger-lib/snapshots ), [hledger ](https://www.stackage.org/package/hledger/snapshots ), [hledger-ui ](https://www.stackage.org/package/hledger-ui/snapshots ), [hledger-web ](https://www.stackage.org/package/hledger-web/snapshots ) < br > [![ ](https://repology.org/badge/version-for-repo/stackage_lts/hledger.svg )](https://repology.org/metapackage/hledger) [![... ](https://repology.org/badge/version-for-repo/stackage_nighly/hledger.svg )](https://repology.org/metapackage/hledger)
2021-09-20 20:17:39 +03:00
| Repology | [quick hledger packaging status ](https://repology.org/metapackage/hledger/badges ), [detailed hledger packaging status ](https://repology.org/project/hledger/versions ), [all \*hledger\* packages ](https://repology.org/metapackages/?search=hledger )
2021-09-20 21:20:19 +03:00
| Debian | source packages: [haskell-hledger-lib ](https://tracker.debian.org/pkg/haskell-hledger-lib ), [bugs ](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=haskell-hledger-lib ), [haskell-hledger ](https://tracker.debian.org/pkg/haskell-hledger ), [bugs ](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=haskell-hledger ), [haskell-hledger-ui ](https://tracker.debian.org/pkg/haskell-hledger-ui ), [bugs ](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=haskell-hledger-ui ), [haskell-hledger-web ](https://tracker.debian.org/pkg/haskell-hledger-web ), [bugs ](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=haskell-hledger-web ) < br > stable: [hledger ](https://packages.debian.org/stable/hledger ), [bugs ](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=hledger;dist=stable ), [hledger-ui ](https://packages.debian.org/stable/hledger-ui ), [bugs ](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=hledger-ui;dist=stable ), [hledger-web ](https://packages.debian.org/stable/hledger-web ), [bugs ](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=hledger-web;dist=stable ) < br > testing: [hledger ](https://packages.debian.org/testing/hledger ), [bugs ](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=hledger;dist=testing ), [hledger-ui ](https://packages.debian.org/testing/hledger-ui ), [bugs ](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=hledger-ui;dist=testing ), [hledger-web ](https://packages.debian.org/testing/hledger-web ), [bugs ](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=hledger-web;dist=testing ) < br > unstable: [hledger ](https://packages.debian.org/unstable/hledger ), [bugs ](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=hledger;dist=unstable ), [hledger-ui ](https://packages.debian.org/unstable/hledger-ui ), [bugs ](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=hledger-ui;dist=unstable ), [hledger-web ](https://packages.debian.org/unstable/hledger-web ), [bugs ](https://bugs.debian.org/cgi-bin/pkgreport.cgi?package=hledger-web;dist=unstable ) < br > all: [\*hledger\* ](https://packages.debian.org/search?searchon=names&keywords=hledger ) < br > sampled install stats: [hledger ](https://qa.debian.org/popcon.php?packages=hledger ), [hledger-ui ](https://qa.debian.org/popcon-graph.php?packages=hledger-ui ), [hledger-web ](https://qa.debian.org/popcon-graph.php?packages=hledger-web )
2021-09-20 21:23:11 +03:00
| Ubuntu | source packages: [haskell-hledger-lib ](https://launchpad.net/ubuntu/+source/haskell-hledger-lib ), [bugs ](https://bugs.launchpad.net/ubuntu/+source/haskell-hledger-lib ), [haskell-hledger ](https://launchpad.net/ubuntu/+source/haskell-hledger ), [bugs ](https://bugs.launchpad.net/ubuntu/+source/haskell-hledger ), [haskell-hledger-ui ](https://launchpad.net/ubuntu/+source/haskell-hledger-ui ), [bugs ](https://bugs.launchpad.net/ubuntu/+source/haskell-hledger-ui ), [haskell-hledger-web ](https://launchpad.net/ubuntu/+source/haskell-hledger-web ), [bugs ](https://bugs.launchpad.net/ubuntu/+source/haskell-hledger-web ) < br > binary packages: [\*hledger\* ](https://packages.ubuntu.com/search?suite=all&searchon=names&keywords=hledger )
| Gentoo | [hledger ](https://gpo.zugaina.org/dev-haskell/hledger ), [hledger-web ](https://gpo.zugaina.org/dev-haskell/hledger-web ), [\*hledger\* ](https://gpo.zugaina.org/Search?search=hledger )
| Fedora | [hledger ](https://apps.fedoraproject.org/packages/hledger ), [\*hledger\* ](https://apps.fedoraproject.org/packages/s/hledger ), [hledger (package db) ](https://admin.fedoraproject.org/pkgdb/package/hledger/ ), [Haskell SIG ](https://fedoraproject.org/wiki/Haskell_SIG )
2020-03-06 20:49:26 +03:00
| Void Linux | [package search ](https://voidlinux.org/packages/ ) -> hledger
2021-09-20 21:23:11 +03:00
| Nix | [\*hledger\* ](https://hydra.nixos.org/search?query=hledger )
2020-04-01 22:17:03 +03:00
| Homebrew | [hledger ](https://formulae.brew.sh/formula/hledger ) < br > our 1-year homebrew rank: < br > 2020: [#1520 of 10000 on mac ](https://formulae.brew.sh/analytics/install-on-request/365d ), [#762 of 8288 on linux ](https://formulae.brew.sh/analytics-linux/install-on-request/365d/ )
2020-03-06 20:49:26 +03:00
| Sandstorm | [hledger web app & reviews ](https://apps.sandstorm.io/app/8x12h6p0x0nrzk73hfq6zh2jxtgyzzcty7qsatkg7jfg2mzw5n90 ), [issues ](https://github.com/simonmichael/hledger/issues?utf8=✓&q=label%3A%22platform%3A%20sandstorm%22%20 )
2020-04-01 22:19:33 +03:00
| Reference | [fosskers GHC compatibility chart ](https://www.fosskers.ca/en/blog/base )
2020-03-06 20:49:26 +03:00
2021-09-20 21:23:11 +03:00
<!-- | hledger-api demo | [api-demo.hledger.org/api/v1/accounts ](https://api-demo.hledger.org/api/v1/accounts ), [api-demo.hledger.org/swagger.json ](https://api-demo.hledger.org/swagger.json ), [in swagger editor ](https://editor2.swagger.io/#/?import=api-demo.hledger.org/swagger.json&no-proxy ) <br> [unfinished angular sample app ](https://api-demo.hledger.org ) ([code](https://github.com/simonmichael/hledger/tree/master/hledger-api/examples/angular)) -->
2020-03-06 20:49:26 +03:00
<!--
2019-01-20 02:27:44 +03:00
| Travis CI | [![... ](https://api.travis-ci.org/simonmichael/hledger.svg?branch=master )](https://travis-ci.org/simonmichael/hledger/builds)
| Appveyor CI | [![... ](https://ci.appveyor.com/api/projects/status/5vejw0w5n5igdr42?svg=true )](https://ci.appveyor.com/project/simonmichael/hledger/history)
2019-02-05 23:14:10 +03:00
| Azure CI | < a href = "https://dev.azure.com/simonmic/hledger/_build" > < img src = "https://dev.azure.com/simonmic/hledger/_apis/build/status/simonmichael.hledger?branchName=master" alt = "..." > < / a >
2020-03-06 20:49:26 +03:00
-->
2019-01-20 02:27:44 +03:00
<!-- list the debian packages for clarity:
3 source:
haskell-hledger-lib
haskell-hledger
haskell-hledger-web
8 binary:
hledger
hledger-web
libghc-hledger-dev
libghc-hledger-doc
libghc-hledger-prof
libghc-hledger-lib-dev
libghc-hledger-lib-doc
libghc-hledger-lib-prof
-->
2019-02-06 02:27:21 +03:00
## Open issues
2020-01-06 21:53:30 +03:00
An overview of hledger's [issue tracker ](https://github.com/simonmichael/hledger/issues ).
A good place to start looking for something to work on.
2020-01-06 21:13:44 +03:00
<!--
This table doesn't have to be aligned, but it helps.
Editing it may require editor support, search/replace etc.
2021-09-20 21:23:11 +03:00
Syntax: https://www.pandoc.org/MANUAL.html#tables -> pipe_tables
2020-01-06 21:13:44 +03:00
-->
2021-09-26 01:16:59 +03:00
| COMPONENT/TOPIC [* ](#topics ) | BUGS | WISHES | PRS | OTHER
|----------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------
2021-05-07 05:00:18 +03:00
| [all ](https://github.com/simonmichael/hledger/issues?q=is:open ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22 ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22 ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22 )
2020-01-06 21:53:30 +03:00
| **Tools:**
2021-05-07 05:00:18 +03:00
| [install ](https://github.com/simonmichael/hledger/issues?q=is:open+label:install ) (hledger-install.sh) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:install ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:install)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:install)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:install)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:install ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:install ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:install )
| [cli ](https://github.com/simonmichael/hledger/issues?q=is:open+label:cli ) (hledger) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:cli ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:cli)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:cli)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:cli)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:cli ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:cli ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:cli )
| [ui ](https://github.com/simonmichael/hledger/issues?q=is:open+label:ui ) (hledger-ui) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:ui ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:ui)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:ui)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:ui)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:ui ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:ui ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:ui )
| [web ](https://github.com/simonmichael/hledger/issues?q=is:open+label:web ) (hledger-web) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:web ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:web)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:web)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:web)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:web ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:web ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:web )
2020-01-06 21:53:30 +03:00
| **Input/Output Formats:**
2021-05-07 05:00:18 +03:00
| [journal ](https://github.com/simonmichael/hledger/issues?q=is:open+label:journal ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:journal ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:journal)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:journal)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:journal)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:journal ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:journal ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:journal )
| [timeclock ](https://github.com/simonmichael/hledger/issues?q=is:open+label:timeclock ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:timeclock ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:timeclock)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:timeclock)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:timeclock)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:timeclock ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:timeclock ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:timeclock )
| [timedot ](https://github.com/simonmichael/hledger/issues?q=is:open+label:timedot ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:timedot ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:timedot)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:timedot)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:timedot)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:timedot ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:timedot ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:timedot )
| [csv ](https://github.com/simonmichael/hledger/issues?q=is:open+label:csv ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:csv ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:csv)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:csv)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:csv)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:csv ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:csv ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:csv )
| [json ](https://github.com/simonmichael/hledger/issues?q=is:open+label:json ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:json ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:json)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:json)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:json)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:json ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:json ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:json )
| [html ](https://github.com/simonmichael/hledger/issues?q=is:open+label:html ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:html ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:html)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:html)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:html)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:html ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:html ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:html )
2020-01-06 21:53:30 +03:00
| **Commands:**
2021-05-07 05:00:18 +03:00
| [accounts ](https://github.com/simonmichael/hledger/issues?q=is:open+label:accounts ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:accounts ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:accounts)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:accounts)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:accounts)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:accounts ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:accounts ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:accounts )
| [activity ](https://github.com/simonmichael/hledger/issues?q=is:open+label:activity ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:activity ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:activity)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:activity)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:activity)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:activity ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:activity ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:activity )
| [add ](https://github.com/simonmichael/hledger/issues?q=is:open+label:add ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:add ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:add)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:add)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:add)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:add ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:add ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:add )
| [balcmds ](https://github.com/simonmichael/hledger/issues?q=is:open+label:balcmds ) (bal/bs/bse/cf/is/...) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:balcmds ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:balcmds)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:balcmds)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:balcmds)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:balcmds ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:balcmds ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:balcmds )
| [balance ](https://github.com/simonmichael/hledger/issues?q=is:open+label:balance ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:balance ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:balance)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:balance)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:balance)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:balance ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:balance ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:balance )
| [balancesheet ](https://github.com/simonmichael/hledger/issues?q=is:open+label:balancesheet ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:balancesheet ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:balancesheet)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:balancesheet)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:balancesheet)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:balancesheet ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:balancesheet ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:balancesheet )
| [cashflow ](https://github.com/simonmichael/hledger/issues?q=is:open+label:cashflow ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:cashflow ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:cashflow)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:cashflow)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:cashflow)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:cashflow ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:cashflow ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:cashflow )
| [checkdates ](https://github.com/simonmichael/hledger/issues?q=is:open+label:checkdates ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:checkdates ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:checkdates)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:checkdates)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:checkdates)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:checkdates ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:checkdates ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:checkdates )
| [checkdupes ](https://github.com/simonmichael/hledger/issues?q=is:open+label:checkdupes ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:checkdupes ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:checkdupes)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:checkdupes)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:checkdupes)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:checkdupes ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:checkdupes ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:checkdupes )
| [close ](https://github.com/simonmichael/hledger/issues?q=is:open+label:close ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:close ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:close)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:close)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:close)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:close ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:close ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:close )
| [import ](https://github.com/simonmichael/hledger/issues?q=is:open+label:import ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:import ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:import)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:import)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:import)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:import ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:import ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:import )
| [incomestatement ](https://github.com/simonmichael/hledger/issues?q=is:open+label:incomestatement ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:incomestatement ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:incomestatement)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:incomestatement)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:incomestatement)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:incomestatement ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:incomestatement ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:incomestatement )
| [prices ](https://github.com/simonmichael/hledger/issues?q=is:open+label:prices ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:prices ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:prices)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:prices)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:prices)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:prices ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:prices ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:prices )
| [print ](https://github.com/simonmichael/hledger/issues?q=is:open+label:print ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:print ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:print)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:print)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:print)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:print ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:print ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:print )
| [printunique ](https://github.com/simonmichael/hledger/issues?q=is:open+label:printunique ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:printunique ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:printunique)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:printunique)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:printunique)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:printunique ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:printunique ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:printunique )
| [register ](https://github.com/simonmichael/hledger/issues?q=is:open+label:register ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:register ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:register)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:register)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:register)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:register ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:register ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:register )
| [registermatch ](https://github.com/simonmichael/hledger/issues?q=is:open+label:registermatch ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:registermatch ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:registermatch)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:registermatch)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:registermatch)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:registermatch ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:registermatch ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:registermatch )
| [rewrite ](https://github.com/simonmichael/hledger/issues?q=is:open+label:rewrite ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:rewrite ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:rewrite)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:rewrite)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:rewrite)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:rewrite ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:rewrite ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:rewrite )
| [roi ](https://github.com/simonmichael/hledger/issues?q=is:open+label:roi ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:roi ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:roi)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:roi)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:roi)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:roi ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:roi ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:roi )
| [stats ](https://github.com/simonmichael/hledger/issues?q=is:open+label:stats ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:stats ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:stats)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:stats)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:stats)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:stats ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:stats ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:stats )
| [tags ](https://github.com/simonmichael/hledger/issues?q=is:open+label:tags ) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:tags ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:tags)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:tags)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:tags)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:tags ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:tags ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:tags )
2020-01-06 21:53:30 +03:00
| **Miscellaneous:**
2021-05-07 05:00:18 +03:00
| [budget ](https://github.com/simonmichael/hledger/issues?q=is:open+label:budget ) (budgeting) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:budget ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:budget)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:budget)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:budget)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:budget ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:budget ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:budget )
| [packaging ](https://github.com/simonmichael/hledger/issues?q=is:open+label:deps ) (packaging, dependencies) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:deps ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:deps)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:deps)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:deps)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:deps ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:deps ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:deps )
| [doc ](https://github.com/simonmichael/hledger/issues?q=is:open+label:doc ) (documentation, help) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:doc ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:doc)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:doc)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:doc)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:doc ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:doc ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:doc )
| [periodexpressions ](https://github.com/simonmichael/hledger/issues?q=is:open+label:periodexpressions ) (-b, -e, -p, date:) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:periodexpressions ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:periodexpressions)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:periodexpressions)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:periodexpressions)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:periodexpressions ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:periodexpressions ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:periodexpressions )
| [site ](https://github.com/simonmichael/hledger/issues?q=is:open+label:site ) (website, web presence) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:site ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:site)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:site)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:site)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:site ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:site ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:site )
| [tools ](https://github.com/simonmichael/hledger/issues?q=is:open+label:tools ) (dev tools, infrastructure) | [bugs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:tools ) ([first](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+label:%22good+first+issue%22+label:tools)/[easy](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+label:easy?+label:tools)/[neither](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+BUG%22+-label:%22good+first+issue%22+-label:easy?+label:tools)) | [wishes ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+label:%22A+WISH%22+label:tools ) | [PRs ](https://github.com/simonmichael/hledger/issues?q=is:open+is:pr+label:tools ) | [other ](https://github.com/simonmichael/hledger/issues?q=is:open+is:issue+-label:%22A+BUG%22+-label:%22A+WISH%22+label:tools )
2019-02-06 02:27:21 +03:00
2019-01-20 02:27:44 +03:00
## About the project
### Mission
Why was hledger created ?
Mainly:
- to provide a more usable, robust, documented, cross-platform-installable version of Ledger for users
- to provide a more maintainable and hackable version of Ledger for developers
Also:
- to provide a useful library and toolbox for finance-minded haskell programmers
- to explore the suitability of Haskell for such applications
- to experiment with building a successful time-and-money-solvent project in a thriving ecosystem of financial software projects
What is the hledger project's current mission ?
1. Provide peace of mind: bring clarity, relief, and peace of mind to folks stressed, confused, overwhelmed by finances.
2. Educate and empower: help individuals and communities achieve clarity, accountability and mastery with money and time.
### Roles and activities
- newcomer/potential user
- user
- library user
- field tester
- bug wrangler
- support
- documentor
- qa
- developer
- packager
- communicator
- project manager
## Getting started
New contributors are always welcome in the hledger project.
2020-12-26 02:54:43 +03:00
Jump in! Or [ask us ](index.html#helpfeedback ) to help you find a task.
2019-01-20 02:27:44 +03:00
### Funder
Become a financial backer to
sustain and grow this project,
increase your influence,
express gratitude,
build prosperity consciousness,
and help transform world finance!
2019-08-29 17:30:20 +03:00
- Use the donate links on the [home page ](https://hledger.org )
2019-01-20 02:27:44 +03:00
- Configure a recurring donation
- Contribute or pledge bounties on issues you care about
- Ask your organization to contribute
- Work on project sustainability, accountability, fundraising
### Tester
- Test installation on platforms you have access to
- Test examples, advice, and links in the docs
- Run the latest release or developer build in daily use
2019-10-18 21:20:04 +03:00
- Run [tests ](#run-package-tests )
- Run [benchmarks ](#run-package-benchmarks )
2019-01-20 02:27:44 +03:00
- Report packaging, documentation, UX, functional, performance issues
- Report and help analyse problems via irc/mail list/bug tracker
When reporting bugs, don't forget to search the tracker for a similar bug report.
Otherwise, open a new bug by clicking "New issue", or < http: / / bugs . hledger . org / new > .
Enhancement requests are sometimes added to the tracker,but for these consider using
2020-12-26 02:54:43 +03:00
the IRC channel and mail list (see [Getting help ](index.html#getting-help )).
2019-01-20 02:27:44 +03:00
Both are archived and linkable, so the idea won't be lost.
There is also a collection of wishes at the old [trello board ](http://trello.hledger.org ).
### Technical Writer
- get familiar with the website and documentation online, review and test
- get familiar with the site/doc source files (see [Shake.hs ](#shake ))
- get the latest hledger source
- send patches with names prefixed with "doc: " (or "site: ")
### Graphics Designer
- more/better logos & graphics
- illustrations and diagrams
- web design mockups for home page, site, hledger-web UI
<!-- ### Product Designer -->
### Communicator
Marketing and market understanding is vital.
- clarify project goals, value proposition, brand, mission, story
- monitor product-market fit
- identify new opportunities
- influence developer priorities
- spread the word!
### Maintainer
#### Help with issue management
- watch tracker activity, report status
- apply/update labels where needed
- follow up on dormant issues
- facilitate a consistently good bug-reporting & PR-contributing experience
#### Help with packaging
- package hledger for linux distros, macports, etc.
- develop mac/windows installers
- find and assist distro packagers/installer developers
#### Help with project management
- clarify/update goals and principles
- monitor, report on project progress and performance
- research, compare and report on successful projects, related projects
- identify collaboration opportunities
- marketing, communication, outreach
- release management, roadmap planning
### Developer
2021-10-31 20:46:10 +03:00
See [Developer workflows ](WORKFLOWS.md#developer-workflows ).
2019-01-20 02:27:44 +03:00