mirror of
https://github.com/simonmichael/hledger.git
synced 2024-11-07 21:15:19 +03:00
docs: wish reporting guidance
This commit is contained in:
parent
54f0e2a288
commit
8956770c29
51
DEVELOP.md
51
DEVELOP.md
@ -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:
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user