docs: wish reporting guidance

This commit is contained in:
Simon Michael 2013-04-14 11:43:26 -07:00
parent 54f0e2a288
commit 8956770c29

View File

@ -4,7 +4,7 @@ title: hledger Developer Guide
# Developer guide # Developer guide
## Quick links **Quick links:**
**hledger released version**<br> **hledger released version**<br>
[release notes](NEWS.html), [release notes](NEWS.html),
@ -20,7 +20,7 @@ title: hledger Developer Guide
packages packages
**hledger development version**<br> **hledger development version**<br>
[Get it](#how-to-set-up-for-hledger-development), [Get it](#how-to-set-up-for-development),
[browse it](http://github.com/simonmichael/hledger), [browse it](http://github.com/simonmichael/hledger),
[changes](http://github.com/simonmichael/hledger/commits), [changes](http://github.com/simonmichael/hledger/commits),
[CHANGES!](http://starlogs.net/#simonmichael/hledger) (turn up your volume) [CHANGES!](http://starlogs.net/#simonmichael/hledger) (turn up your volume)
@ -46,35 +46,38 @@ or
/><input type="submit" value="search released API docs" /><input type="submit" value="search released API docs"
/></span> /></span>
</form> </form>
\
## How to.. ## 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) ### how to suggest enhancements
- discuss/confirm the issue on irc or list
- report new issues in the bug tracker
<!-- - test and share problem journal snippets at paste . hledger.org -->
### 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 Wishes *are* welcome feedback, but we don't want them to pile up and
- download and test the binaries on your platform obscure bugs and other developer priorities, so we manage them with discussion
- test installing via cabal and optionally as cards on a trello board.
- use the tools and test functionality, usability, browser compatibility, ui layout etc. The current recommendation is
- 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
### 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 2. **report wishes on trello, bugs in the bug tracker**\
- research and update issues Is it a problem with the released and documented functionality ? report in the [bug tracker](http://hledger.org/bugs)\
- some convenient url shortcuts: Is it a wish ? add a card on the [trello board](http://hledger.org/trello), if needed
[`hledger.org/bugs`](http://hledger.org/bugs)
[`hledger.org/bugs/new`](http://hledger.org/bugs/new) 3. **don't sweat it**\
`hledger.org/bugs/N` Or, do what you think best. If a wish does land in the bug tracker, it gets the WISH label.
### how to report problems ### how to report problems
@ -102,7 +105,7 @@ or
[`hledger.org/bugs/new`](http://hledger.org/bugs/new) [`hledger.org/bugs/new`](http://hledger.org/bugs/new)
`hledger.org/bugs/N` `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 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 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`. 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. 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: Follow the usual github workflow: