notes cleanup

This commit is contained in:
Simon Michael 2009-04-03 21:02:45 +00:00
parent 1548e84aa9
commit 8e5640b432

170
NOTES
View File

@ -8,49 +8,42 @@ implementations were its consequences." --Niklaus Wirth
skull. He therefore approaches his task with full humility, and avoids skull. He therefore approaches his task with full humility, and avoids
clever tricks like the plague." --Edsger Dijkstra clever tricks like the plague." --Edsger Dijkstra
We aim to make reliable, maintainable, usable software, sustainably.
- pair programming
- test-driven development
- fixes, docs, deployment testing before features
- "bugs" are "errors", as in "the programmer messed up"
- test continuously and thoroughly (code, doc, speed tests/measurement on each commit, release)
- less is more
* to do * to do
** errors ** errors
** features *** hledger web & gives an error ?
*** more ledger features ** testing
**** rename entry -> transaction, transaction -> posting *** run ledger 3 baseline tests
**** -U --uncleared *** test all ledger file format features
**** actual/effective entry & txn dates, for more accurate modelling & easier reconciliation
**** ~/.hledgerrc for setting defaults
**** support complete period syntax ?
every N days # N is any integer
every N weeks
every N months
every N quarters
every N years
biweekly
bimonthly
**** allow - before currency symbol ?
*** new features
**** a simpler timelog balance report format for clients
**** more date syntax: last nov, next friday, optional this, week of
**** allow comment lines immediately after or within an entry
**** accept multiple -f files
**** more reliable tidy layout from print
**** -Q quarterly interval option, for consistency/convenience ?
**** web gui
**** charts
**** easier data entry
**** parse more file formats - gnucash, qif, ofx, csv..
**** easier timelog format
**** i18n
*** speed
**** more optimisation
**** speed regression tests
** tests
*** test all esoteric ledger file features
*** test reading from stdin *** test reading from stdin
*** easy ledger compatibility testing *** --compare (xml?) output with ledger's ?
**** run ledger 3 baseline tests *** clarify hledgerisms in file format - that hledger can read but ledger can't
**** --compare (xml?) output with ledger's *** build with -Wall and anything else useful
** docs *** build with multiple ghc versions
*** hledgerisms in file format - that hledger can read but ledger can't ** docs & marketing
*** complete docs for smart dates, period expressions *** document smart dates, period expressions, display expressions
*** funding *** automate readme
**** keep in sync (automate)
***** README file
****** options list in Features should match Options.hs, generate from hledger --help ?
***** hledger.hs module description
***** hledger.cabal description field (exclude home page link)
***** home page description (http://joyful.com/Hledger/editform)
***** mail list description (http://groups.google.com/groups/hledger -> edit welcome msg)
***** gmane description
***** darcsweb description
*** automate announcements
**** generate from README and NEWS
*** develop funding
**** license change ?
**** donate button, see chimoo guy
**** funding document 2009/01 **** funding document 2009/01
======= =======
funding funding
@ -248,59 +241,60 @@ competitors/fellow niche inhabitants
have you considered talking to business who hate their financial sw and going from there have you considered talking to business who hate their financial sw and going from there
***** gwern ***** gwern
most haskellers have never heard of hledger, sounds arrogant or hubristic to talk of charging for it most haskellers have never heard of hledger, sounds arrogant or hubristic to talk of charging for it
*** --version
*** --help **** qooxledger
*** readme *** better user manual
**** keep in sync (automate) *** screencasts
***** README file *** better screenshots
****** options list in Features should match Options.hs, generate from hledger --help ? *** developer docs
***** hledger.hs module description **** style guide, see also above
***** hledger.cabal description field (exclude home page link) **** unsafe things which may fail at runtime
***** home page description (http://joyful.com/Hledger/editform) ***** incomplete pattern matching
***** mail list description (http://groups.google.com/groups/hledger -> edit welcome msg) ***** error
***** gmane description ***** printf
***** darcsweb description ** packaging & deployment
*** announcements
**** generate from README and NEWS
*** release notes
**** NEWS
*** implementation docs
*** api docs
*** developer intro
**** style tips
***** we aim to make reliable software:
****** fixes come before features
****** "bugs" get called "errors", as in "the programmer messed up"
****** we test continuously and thoroughly (code, doc & speed tests on each checkin)
****** less is more
*** user manual
*** other differences not noted in README
**** ledger shows description comments as part of description
**** ledger seems to get amounts' x-position wrong more than hledger
**** ledger can't parse full smart dates in display expressions
**** hledger print puts a blank line after the entry, not before it
**** ledger can get timelog entry balance wrong, see mail list
**** ledger reports timelog sessions as virtual transactions
** packaging, web presence, etc.
*** make installation easier *** make installation easier
**** on all platforms **** on all platforms
***** via cabal install ***** set up binary publishing
***** via downloading packages from hackage ***** reduce dependencies
****** drop regexpr
***** split packages ?
***** set up the hours alias
**** on linux **** on linux
***** on debian ***** debian
***** on ubuntu ***** ubuntu
***** on redhat
***** on arch
***** via binaries
**** on mac **** on mac
***** via ports ***** ports
***** via binaries ***** binary
**** on windows **** on windows
***** via binaries ***** binary
*** reduce dependencies *** cabal haddock
**** split packages ? *** cabal test
*** set up binary publishing ** code cleanup
*** clarify bugtracking process *** seek more modularity
*** try export lists
*** graph and reduce dependencies
*** pair programming
** features/wishlist
*** --flat timelog balance report option for clients
*** alternative easy timelog format
*** better web gui
*** nice reports with charts
*** data entry!
*** watching a changing journal
*** actual & effective txn & posting dates ?
*** wide format
*** more date syntax ? last nov, next friday, optional this, week of
*** more period syntax ? every N days, biweekly
*** allow comment lines immediately after or within an entry
*** accept multiple -f files
*** more reliable tidy layout from print
*** parse more file formats - gnucash, qif, ofx, csv..
*** i18n
*** speed
**** optimisation
**** speed regression tests
*** plugins
* misc * misc
** things I want to know ** things I want to know
*** time *** time