Browse Source

Stuffs

dec2021
j3s 2 years ago
parent
commit
5f58dd370c
  1. 2
      .gitignore
  2. 6
      make
  3. 11
      site/docs.txt
  4. 62
      site/docs/git.txt
  5. 3
      site/docs/matrix.txt
  6. 13
      site/docs/mkdoc

2
.gitignore vendored

@ -1 +1 @@
docs
build/

6
make

@ -27,9 +27,9 @@ cat <<EOF > /tmp/meow
</pre></pre>
EOF
rm -f docs/*.txt docs/*.html
mkdir -p docs
cd docs
rm -f build/*.txt build/*.html
mkdir -p build
cd build
# Iterate over each file in the source tree under /site/.
(cd ../si*; find . -type f -a -not -path \*/\.\* -a -not -path ./templates/\*) |

11
site/docs.txt

@ -0,0 +1,11 @@
+-------------------------------------------------------+
| |
| DOCS |
| |
| * all docs for all services and workflows be here |
| |
| |
+-------------------------------------------------------+
- <a href=/docs/matrix>matrix</a>
- <a href=/docs/git>git</a>

62
site/docs/git.txt

@ -0,0 +1,62 @@
Service: git
Owner: j3s@c3f.net
Updated: 1582677189
Cgit is an internal service used by many members of
Cyberia for version control purposes. It also serves as a
source of truth for many of our records. We use
https://git.zx2c4.com/cgit by Jason Donenfeld with a
custom CSS theme.
================
== Quickstart ==
================
Click `cgit` on your navigation bar. :)
================
== How-Tos ==
================
When I clone a repository, which URL should I use?
==================================================
There are two URLs, and they serve different purposes.
- `ssh://` is a read-write URL. Use it if you plan on
running `git push`.
- `https://` is a read-only URL. Use it if you don't plan
on running `git push`.
================
== Resources ==
================
Philosophy
==========
Git is meant to be straightforward, and we use it as
intended. A simple remote repository, with no frills,
that hosts our code and gives us a space to collaborate.
We submit patches via mailing list - this gives us a
universal code delta (git + a diff) over a universal
medium (email).
currently, patches should be sent to `misc@c3f.net`.
Is the server backed up?
========================
Yeah, all of git is backed up many times per day to a
redundant ZFS volume.
How do I see files?
===================
Go to a repo and click `tree`.
================
== Changelog ==
================
- 2020-01-31: cgit was moved to a new URL (from
git.cyberia.club to cyberia.club/cgit)
- 2020-02-25: cgit was moved back to its'
original URL

3
site/docs/matrix.txt

@ -0,0 +1,3 @@
Service: matrix
Owner: misc@c3f.net
Updated: 1582677130

13
site/docs/mkdoc

@ -0,0 +1,13 @@
#!/bin/sh -e
doc="$1"
cat > "$doc.txt" <<EOF
Service: $1
Owner: misc@c3f.net
Updated: $(date +%s)
EOF
entry="- <a href=/docs/$doc>$1</a>"
echo "$entry" | tee -a ../docs.txt
Loading…
Cancel
Save