summaryrefslogtreecommitdiff
path: root/doc/euandre.org.en.0.adoc
diff options
context:
space:
mode:
authorEuAndreh <eu@euandre.org>2026-09-10 12:00:04 -0300
committerEuAndreh <eu@euandre.org>2026-09-10 12:00:13 -0300
commit9ec6794d8f04b7970e1401cae1d0d20321de3204 (patch)
treeeee45364e8ba422cfcebd452eaa50cb82fa918ea /doc/euandre.org.en.0.adoc
parentName the i18n stamp a sentinel (diff)
downloadeuandre.org-9ec6794d8f04b7970e1401cae1d0d20321de3204.tar.gz
euandre.org-9ec6794d8f04b7970e1401cae1d0d20321de3204.tar.xz
Carry the pages every repository carries
The eight English section pages were missing, and with them the root CHANGELOG.adoc and TODOs.adoc: what changed between two releases and what is known to be left are not things a reader can work out from the tree. 7README, 7CHANGELOG and 7TODOs are symlinks to the root documents, as they are everywhere else. 0 links the rest, 7tutorial writes one page start to finish, 7recipes has the tasks that come after that, and 7why says why the site is built this way. 3 is a reference page for a library, and a website has none; it says so, and exists because a reader who knows where to look in one repository should know where to look in all of them. README.adoc gains the manpage title and NAME section the 7README symlink needs to render, its prose unchanged. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KxLpaNQThKfMG3ecCJptP9
Diffstat (limited to '')
-rw-r--r--doc/euandre.org.en.0.adoc58
1 files changed, 58 insertions, 0 deletions
diff --git a/doc/euandre.org.en.0.adoc b/doc/euandre.org.en.0.adoc
new file mode 100644
index 0000000..6d461c4
--- /dev/null
+++ b/doc/euandre.org.en.0.adoc
@@ -0,0 +1,58 @@
+= euandre.org(0)
+
+
+
+== NAME
+
+euandre.org - a personal website in six languages, built from asciidoc
+
+
+
+== DESCRIPTION
+
+The manual for the repository that builds https://euandre.org. It is
+a website, not a program: there is nothing here to install on a PATH,
+and what the pages describe is how the site is written and built.
+
+*euandre.org*(7README)::
+ What the site is, what builds it, and the licences it carries.
+
+*euandre.org*(7tutorial)::
+ Adding a page, from the empty file to the built HTML.
+
+*euandre.org*(7recipes)::
+ The tasks that come up once the shape is familiar: a translation, a
+ slide deck, a redirect, a deploy.
+
+*euandre.org*(7why)::
+ Why the site is built this way rather than another.
+
+*euandre.org*(7CHANGELOG), *euandre.org*(7TODOs)::
+ What has changed, and what is known to be left.
+
+The build rules are not this repository's own. `mkdeps.sh` ends with
+`mkwb rules`, which writes them into `deps.mk`; what is kept here is
+only what is this site's --- its name, its languages, its port. For
+the rules themselves see *mkwb*(1).
+
+
+
+== SEE ALSO
+
+*mkwb*(1), *adocg*(1), *po4a*(1), *eslaides*(1)
+
+
+
+== AUTHORS
+
+mailto:eu@euandre.org[EuAndreh] and contributors.
+
+
+
+== BUGS
+
+* Report bugs to the mailto:~euandreh/public-inbox@lists.sr.ht[mailing list].
+ Use the subject "[euandre.org] BUG or TASK: <description>".
+* Browse bugs https://euandre.org/git/euandre.org/TODOs.html[online].
+* https://euandre.org/git/euandre.org/[Homepage].
+* https://lists.sr.ht/~euandreh/public-inbox?search=%5Beuandre%2Eorg%5D[Comments and discussions].