for the reference section do you prefer tabular format with shorts descriptions, or long form prose with longer explanations for each command, or both?
On Thu, Oct 4, 2012 at 1:52 PM, Peter Keen <[email protected]> wrote: > On Thu, Oct 4, 2012 at 1:45 PM, Craig Earls <[email protected]> wrote: > >> After languishing for longer than I am happy to admit, I am getting back >> into the manual. I have the same problem now that brought me to a dead >> stop several months ago: the overall structure. >> >> Ledger is incredibly complex, and, frankly, I am at a loss on how to >> really approach it correctly. Some parts of the current manual are >> tutorial in nature, other parts are list of command options. They don't >> flow together and it isn't even clear to me where I should look to find >> anything in particular. So I beg you to give me some suggestions to help >> break through this block. >> > > I think two main sections would be good. One section would be the tutorial > and "Keeping a journal with ledger" content, and the other section would be > strictly reference, organized by subcommand. Global options before the > subcommands, subcommand-specific options within their respective sections. > Formatting and expressions probably deserve their own part of the reference > section as well. > > >> >> Also, there are many, many entries in the lists of options/cmmands that >> say FIX THIS ENTRY. Because I don't have a decent understanding of some of >> the more arcane ones. If you see one that you understand please submit an >> entry to me. >> >> -- >> Craig, Corona De Tucson, AZ >> enderw88.wordpress.com >> > > -- Craig, Corona De Tucson, AZ enderw88.wordpress.com
