git-query

commit 4a1e5a5220283a3d11437d0be67d6170bc71f1e3
parent 658e9327cdf7f793e55c4bdb1b8d9a4c62d42e64
Author: Jul <jul@9o.is>
Date:   Tue,  3 Mar 2026 16:57:52 +0800

add motivation in readme

Diffstat:
M
README
 | 
14
+++++++++++---

1 file changed, 11 insertions(+), 3 deletions(-)
diff --git a/README b/README
@@ -1,11 +1,19 @@
 git-query
---------
+=========
 
 Git data extraction tool.
 
-It extracts git repository data in XML format, suitable for piping to
-other tools or templating.
+It extracts a minimal set of git repository data in XML format, suitable for piping to
+other templating tools.
+
+Motivation
+----------
 
+This is a fork of stagit, kept here for reference. stagit is a great static git page
+generator, but its HTML output is hardcoded into the binary. If you want different styling,
+layouts, or to integrate with other tools, you're limited. I don't use this
+as git cli commands suffice for creating html templates with the `--format` flag, and git's
+tabular ouput can be parsed and joined with awk or the unix `join` command.
 
 Usage
 -----