2021-09-27 14:44:14 +03:00
|
|
|
|
# Docs
|
|
|
|
|
|
2021-09-27 14:56:13 +03:00
|
|
|
|
<div class=pagetoc>
|
|
|
|
|
<!-- toc -->
|
|
|
|
|
</div>
|
|
|
|
|
|
2021-09-27 14:44:14 +03:00
|
|
|
|
20191209: needs update. See also doc/README.
|
|
|
|
|
|
|
|
|
|
## Four kinds of documentation
|
|
|
|
|
|
|
|
|
|
<div style="margin:1em 2em; font-style:italic;">
|
|
|
|
|
"There is a secret that needs to be understood in order to write good
|
|
|
|
|
software documentation: there isn’t one thing called documentation,
|
|
|
|
|
there are four. They are: tutorials, how-to guides, explanation and
|
|
|
|
|
technical reference. They represent four different purposes or
|
|
|
|
|
functions, and require four different approaches to their creation."
|
|
|
|
|
--[Daniele Procida] (https://news.ycombinator.com/item?id=21289832)
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
https://github.com/simonmichael/hledger/tree/master/doc
|
|
|
|
|
|
|
|
|
|
Project documentation lives in a number of places:
|
|
|
|
|
|
|
|
|
|
- `site/*.md` is the hledger.org website content, which is generated with hakyll[-std] and pandoc
|
|
|
|
|
- haddock documentation in the code appears on Hackage
|
|
|
|
|
- short blurbs: cabal files, module headers, HCAR, GSOC project, ..
|
|
|
|
|
- `doc/notes.org` has some old developer notes
|
|
|
|
|
- developer reports (profiles, benchmarks, coverage..) in doc/profs, sometimes published at hledger.org/profs
|
|
|
|
|
|