From 246ff54e6c929877409513fa4bb4afc491b2feb3 Mon Sep 17 00:00:00 2001 From: "reaction.la" Date: Mon, 25 Jul 2022 02:04:34 -0700 Subject: [PATCH] structuring this random pile of documents preparatory to making it actually accessible --- docs/mkdocs.sh | 25 +++++++++++++++++++ docs/rootDocs/NOTICE.md | 2 +- docs/rootDocs/README.md | 2 +- .../contributor_code_of_conduct.md | 0 docs/{ => setup}/dovecot.md | 0 .../download_and_build_on_windows.md | 0 docs/setup/icon.pandoc | 1 + docs/{ => setup}/set_up_build_environments.md | 0 docs/social_networking.md | 10 +++++++- 9 files changed, 37 insertions(+), 3 deletions(-) rename docs/{ => setup}/contributor_code_of_conduct.md (100%) rename docs/{ => setup}/dovecot.md (100%) rename docs/{ => setup}/download_and_build_on_windows.md (100%) create mode 100644 docs/setup/icon.pandoc rename docs/{ => setup}/set_up_build_environments.md (100%) diff --git a/docs/mkdocs.sh b/docs/mkdocs.sh index 170015d..4e1329f 100644 --- a/docs/mkdocs.sh +++ b/docs/mkdocs.sh @@ -91,6 +91,31 @@ do fi done cd .. +cd setup +options=$osoptions"--toc -N --toc-depth=5 --wrap=preserve --metadata=lang:en --include-in-header=./icon.pandoc --include-before-body=$templates/before.pandoc --css=$templates/style.css --include-after-body=$templates/after.pandoc -o" +pwd +for f in *.md +do + len=${#f} + base=${f:0:($len-3)} + if [ $f -nt $base.html ]; + then + katex="" + for i in 1 2 3 4 + do + read line + if [[ $line =~ katex ]]; + then + katex=" --katex=./" + fi + done <$f + echo "generating $base.html from $f" + pandoc $katex $options $base.html $base.md + #else + # echo " $base.html up to date" + fi +done +cd .. cd rootDocs pwd katex="" diff --git a/docs/rootDocs/NOTICE.md b/docs/rootDocs/NOTICE.md index 4eb8f95..44b2ba1 100644 --- a/docs/rootDocs/NOTICE.md +++ b/docs/rootDocs/NOTICE.md @@ -19,4 +19,4 @@ This product includes several packages, each with their own free software licenc Or, in the case of Sqlite, the Sqlite blessing in place of a license, which is morally though not legally obligatory on those that obey the -commandments of Gnon. See also the [contributor code of conduct](docs/contributor_code_of_conduct.html). +commandments of Gnon. See also the [contributor code of conduct](docs/setup/contributor_code_of_conduct.html). diff --git a/docs/rootDocs/README.md b/docs/rootDocs/README.md index 6500ad8..9742763 100644 --- a/docs/rootDocs/README.md +++ b/docs/rootDocs/README.md @@ -74,7 +74,7 @@ git config --local include.path ../.gitconfig this will substantially mitigate the problem of submodules failing to update in pushes, pulls, checkouts, and switches. -[cryptographic software is under attack]:./docs/contributor_code_of_conduct.html#code-will-be-cryptographically-signed +[cryptographic software is under attack]:./docs/setup/contributor_code_of_conduct.html#code-will-be-cryptographically-signed "Contributor Code of Conduct" {target="_blank"} diff --git a/docs/contributor_code_of_conduct.md b/docs/setup/contributor_code_of_conduct.md similarity index 100% rename from docs/contributor_code_of_conduct.md rename to docs/setup/contributor_code_of_conduct.md diff --git a/docs/dovecot.md b/docs/setup/dovecot.md similarity index 100% rename from docs/dovecot.md rename to docs/setup/dovecot.md diff --git a/docs/download_and_build_on_windows.md b/docs/setup/download_and_build_on_windows.md similarity index 100% rename from docs/download_and_build_on_windows.md rename to docs/setup/download_and_build_on_windows.md diff --git a/docs/setup/icon.pandoc b/docs/setup/icon.pandoc new file mode 100644 index 0000000..f43d0b9 --- /dev/null +++ b/docs/setup/icon.pandoc @@ -0,0 +1 @@ + diff --git a/docs/set_up_build_environments.md b/docs/setup/set_up_build_environments.md similarity index 100% rename from docs/set_up_build_environments.md rename to docs/setup/set_up_build_environments.md diff --git a/docs/social_networking.md b/docs/social_networking.md index 084efcd..55b06f3 100644 --- a/docs/social_networking.md +++ b/docs/social_networking.md @@ -353,9 +353,17 @@ unlimited power, nor allow them to be a central point of failure. ### runningt in schism, with many approximately equal branches +Centralized databases are a single point of failure. They are also extremely +convenient, because they enable many humans to leverage the judgment of +a single human, rather than needing to exercise their own judgement. + +With Git, you usually have one master repository. Sometimes you do not, +and have to exercise your own judgement. I have often enough tripped +over this, and often enough managed fine. + Under attack, the system may well schism, with no one source that lists all or most Zooko identities that people are interested in contacting, but it -should, like git, be designed to schism, and work well enough while +should, like Git, be designed to schism, and work well enough while schismed. That is what makes Git centralization truly decentralized. Sometimes, often, there is no one authoritative branch, and things still work.