diff --git a/DEVELOP.md b/DEVELOP.md
index b2c4084ab..4f81b4b28 100644
--- a/DEVELOP.md
+++ b/DEVELOP.md
@@ -4,7 +4,7 @@ title: hledger Developer Guide
# Developer guide
-## Quick links
+**Quick links:**
**hledger released version**
[release notes](NEWS.html),
@@ -20,7 +20,7 @@ title: hledger Developer Guide
packages
**hledger development version**
- [Get it](#how-to-set-up-for-hledger-development),
+ [Get it](#how-to-set-up-for-development),
[browse it](http://github.com/simonmichael/hledger),
[changes](http://github.com/simonmichael/hledger/commits),
[CHANGES!](http://starlogs.net/#simonmichael/hledger) (turn up your volume)
@@ -46,35 +46,38 @@ or
/>
+\
## How to..
-### how to report problems
+New contributors of all levels are most welcome.
+Here are some tips to help you get productive on the hledger project.
-- check for related issues in the [bug tracker](http://hledger.org/bugs) or in the [mail list archive](http://hledger.org/list)
-- discuss/confirm the issue on irc or list
-- report new issues in the bug tracker
-
+### how to suggest enhancements
-### how to help with testing
+Suggestions and feature requests are easy to make, less easy to
+research, and hard to implement. And, alas! We don't have a team of
+sleek, well-fed, idle coders standing by to implement everybody's
+wishes. (Please
+[help change that](#how-to-set-up-for-hledger-development)).
-- review and test our documentation and web presence
-- download and test the binaries on your platform
-- test installing via cabal
-- use the tools and test functionality, usability, browser compatibility, ui layout etc.
-- check that `hledger test` reports no failures
-- [run the developer tests](#how-to-run-the-tests)
-- discuss/report problems via irc/mail list/bug tracker
+Wishes *are* welcome feedback, but we don't want them to pile up and
+obscure bugs and other developer priorities, so we manage them with discussion
+and optionally as cards on a trello board.
+The current recommendation is
-### how to help with bug tracking
+1. **discuss/research first**\
+ Is your wish already on the [trello wishlist/planning board](http://hledger.org/trello)
+ or [bug tracker](http://hledger.org/bugs) ?\
+ Perhaps discuss it on [irc](irc://irc.freenode.net/#ledger), the [mail list](http://hledger.org/list) or trello ?
-- get to know the [bug tracker](http://hledger.org/bugs) and its contents
-- research and update issues
-- some convenient url shortcuts:
- [`hledger.org/bugs`](http://hledger.org/bugs)
- [`hledger.org/bugs/new`](http://hledger.org/bugs/new)
- `hledger.org/bugs/N`
+2. **report wishes on trello, bugs in the bug tracker**\
+ Is it a problem with the released and documented functionality ? report in the [bug tracker](http://hledger.org/bugs)\
+ Is it a wish ? add a card on the [trello board](http://hledger.org/trello), if needed
+
+3. **don't sweat it**\
+ Or, do what you think best. If a wish does land in the bug tracker, it gets the WISH label.
### how to report problems
@@ -102,7 +105,7 @@ or
[`hledger.org/bugs/new`](http://hledger.org/bugs/new)
`hledger.org/bugs/N`
-### how to set up for hledger development
+### how to set up for development
1. get an up-to-date [ghc](http://haskell.org/ghc), at least 7.0 and preferably 7.6
2. there's probably no need to install the [haskell platform](http://haskell.org/platform) now, but you could
@@ -139,7 +142,7 @@ or
You'll need to follow the instructions to install `sp`.
This is how I do most hledger development. It will recompile whenever you save changes to source files.
-### how to get your patch committed
+### how to get your changes accepted
Follow the usual github workflow: