From 934f0e3cd6aeaf3140472a7f03f15dcc94da07b0 Mon Sep 17 00:00:00 2001
From: Simon Michael <simon@joyful.com>
Date: Sun, 4 Dec 2022 12:16:53 -0800
Subject: [PATCH] ;doc: REPOS, FILES

---
 doc/FILES.md | 151 +++++++++++++++++++++++++++++++++++++++++++++++++++
 doc/REPOS.md |  21 +++++++
 2 files changed, 172 insertions(+)
 create mode 100644 doc/FILES.md
 create mode 100644 doc/REPOS.md

diff --git a/doc/FILES.md b/doc/FILES.md
new file mode 100644
index 000000000..95545dfb5
--- /dev/null
+++ b/doc/FILES.md
@@ -0,0 +1,151 @@
+# Files
+
+<div class=pagetoc>
+
+<!-- toc -->
+</div>
+
+Overviews of files in the hledger project, as of 2022-12.
+
+## hledger repo directories
+
+<pre>
+$ (cd ~/src/hledger; tre -d)
+.
+├── .github
+│   ├── ISSUE_TEMPLATE
+│   └── workflows
+│       └── old
+├── .sandstorm
+├── bin
+├── checks
+├── doc
+│   ├── haskellerz
+│   ├── hcar
+│   ├── mockups
+│   └── profs
+├── docker-static-arm32v7
+├── docker
+├── examples
+│   ├── budgeting
+│   ├── csv
+│   ├── investing
+│   ├── invoicing
+│   │   ├── invoice-script
+│   │   └── makefile
+│   ├── reports
+│   ├── systemd
+│   └── templates
+│       └── basic
+├── hledger-install
+├── hledger-lib
+│   ├── Hledger
+│   │   ├── Data
+│   │   │   └── JournalChecks
+│   │   ├── Read
+│   │   ├── Reports
+│   │   └── Utils
+│   ├── Text
+│   │   ├── Megaparsec
+│   │   └── Tabular
+│   ├── other
+│   │   └── ledger-parse
+│   │       └── Ledger
+│   │           └── Parser
+│   └── test
+├── hledger-ui
+│   ├── Hledger
+│   │   └── UI
+│   └── test
+├── hledger-web
+│   ├── Hledger
+│   │   └── Web
+│   │       ├── Handler
+│   │       ├── Settings
+│   │       └── Widget
+│   ├── app
+│   ├── config
+│   ├── deploy
+│   ├── static
+│   │   ├── css
+│   │   ├── fonts
+│   │   └── js
+│   ├── templates
+│   └── test
+├── hledger
+│   ├── Hledger
+│   │   └── Cli
+│   │       └── Commands
+│   ├── app
+│   ├── bench
+│   ├── embeddedfiles
+│   ├── shell-completion
+│   └── test
+│       ├── addons
+│       ├── balance
+│       ├── cli
+│       ├── errors
+│       ├── i18n
+│       ├── import
+│       ├── journal
+│       │   └── account-display-order
+│       │       └── 1
+│       ├── print
+│       └── register
+└── tools
+</pre>
+
+## site repo directories
+
+<pre>
+$ (cd ~/src/hledger/site; tre -d)
+.
+├── css
+├── js
+├── src
+│   ├── 1.0
+│   ├── 1.1
+│   ├── 1.10
+│   ├── 1.11
+│   ├── 1.12
+│   ├── 1.13
+│   ├── 1.14
+│   ├── 1.15
+│   ├── 1.16
+│   ├── 1.17
+│   ├── 1.18
+│   ├── 1.19
+│   ├── 1.2
+│   ├── 1.20
+│   ├── 1.21
+│   ├── 1.22
+│   ├── 1.23
+│   ├── 1.24
+│   ├── 1.25
+│   ├── 1.26
+│   ├── 1.27
+│   ├── 1.28
+│   ├── 1.3
+│   ├── 1.4
+│   ├── 1.5
+│   ├── 1.9
+│   ├── dev
+│   ├── fonts
+│   ├── highslide
+│   │   └── graphics
+│   │       └── outlines
+│   └── images
+│       ├── hledger-ui
+│       └── hledger-web
+│           ├── normal
+│           └── small
+└── theme
+    └── css
+</pre>
+
+## finance repo directories
+
+<pre>
+$ (cd ~/src/hledger/finance; tre -d)
+.
+</pre>
diff --git a/doc/REPOS.md b/doc/REPOS.md
new file mode 100644
index 000000000..5bfadb25d
--- /dev/null
+++ b/doc/REPOS.md
@@ -0,0 +1,21 @@
+# Repositories
+
+Source code and content related to hledger are kept in revision control repositories,
+mostly using [Git](https://en.wikipedia.org/wiki/Git).
+
+The official repos:
+
+- The main repo: hledger, hledger-ui & hledger-web code, user manuals, developer docs.\
+  <https://github.com/simonmichael/hledger> (shortcut url: <http://code.hledger.org>)
+  
+
+- The site repo: hledger.org website, additional hledger docs.\
+  <https://github.com/simonmichael/hledger_site> (<http://site.hledger.org>)
+  
+
+- The finance repo: project financial journals and reports.\
+  <https://github.com/simonmichael/hledger_finance> (<http://finance.hledger.org>)
+  
+
+Other repos exist for third-party hledger tools (hledger-iadd, hledger-interest, etc.)
+and packages.