hledger-mode icon indicating copy to clipboard operation
hledger-mode copied to clipboard

Lacking documentation

Open DamienCassou opened this issue 4 years ago • 8 comments

Hi,

thank you for your package. I think the project lacks some documentation. For example:

  1. the animated GIF in the README looks great but the features it demonstrates are not described anywhere. Would it be possible to have a list of the commands used in the demo?
  2. I don't see any list of features that the package supports nor how to use any feature.

DamienCassou avatar Jan 01 '21 16:01 DamienCassou

I totally agree. When I started working on this, I was building it mostly for myself. Some features are not used at all (not even by me). It's possible they do not work anymore. I will definitely add the commands that the demo uses to the Readme.md soon.

narendraj9 avatar Jan 21 '21 09:01 narendraj9

Hi @narendraj9. I use ledger-mode because of some useful features and it is a while since I tried hledger-mode. I see there were some commits last year. Are you looking for more contributors ? A useful addition to the readme could be a comparison with ledger-mode, reasons to use one or the other, and maybe more discussion of next steps if any ?

simonmichael avatar Apr 27 '23 16:04 simonmichael

Also, FWIW the example emacs config is probably full of useful tips, but at first glance it scared me - could be worth also showing a minimal one for getting started ?

simonmichael avatar Apr 27 '23 16:04 simonmichael

could be worth also showing a minimal one

Oops, it's already there - my bad!

simonmichael avatar Apr 27 '23 17:04 simonmichael

Hi @narendraj9. I use ledger-mode because of some useful features and it is a while since I tried hledger-mode. I see there were some commits last year. Are you looking for more contributors ? A useful addition to the readme could be a comparison with ledger-mode, reasons to use one or the other, and maybe more discussion of next steps if any ?

Hey @simonmichael , I am not actively working on the project. If you would like to contribute or become a maintainer, that will be great :)

narendraj9 avatar May 18 '23 08:05 narendraj9

Thanks for the update @narendraj9. I use ledger-mode myself and don't have time to help much with this, but I'll put the word out.

simonmichael avatar May 18 '23 08:05 simonmichael