README.txt is now README.md because why not. Also included an obnoxious comment...
authorArt Cancro <ajc@citadel.org>
Sun, 11 Sep 2022 00:13:44 +0000 (20:13 -0400)
committerArt Cancro <ajc@citadel.org>
Sun, 11 Sep 2022 00:13:44 +0000 (20:13 -0400)
webcit-ng/README.md [new file with mode: 0644]
webcit-ng/README.txt [deleted file]

diff --git a/webcit-ng/README.md b/webcit-ng/README.md
new file mode 100644 (file)
index 0000000..07910d8
--- /dev/null
@@ -0,0 +1,32 @@
+# WebCit-NG
+
+This is WebCit-NG, a complete refactoring of the WebCit server that will
+focus on "REST first" and build around that.  The code will be well
+layered with as little spaghetti as possible.
+
+Please don't mess with this yet.  I'm only pushing it upstream so it gets backed up.
+
+Yes, I know the Makefile is built in a way that forces it to recompile everything
+when you touch even one file.  For the time being this is acceptable.
+
+## Design goals
+*      Hold as little state as possible
+*      Require NO cleanup.   Killing the process lets the OS reclaim all resources.
+*      As much as possible, resources should be freed by just coming back down the stack.
+       Avoid global variables and thread-local variables as much as possible.
+*      Readability of the code is more important than shaving off a few CPU cycles.
+*      Throw sensitive data such as passwords back and forth in clear text.
+       If you want privacy, encrypt the whole session.  Anything else is false security.
+
+REST format URLs will generally take the form of:
+
+       /ctdl/objectClass/[container/]object[/operation]
+
+## We are using
+*      libcitadel for information about the Citadel server, some string handling, and the JSON encoder
+*      Expat for DAV handling
+*      OpenSSL for TLS
+
+## We are NOT using
+* Your favorite javascript library
+* Your favorite CSS framework
diff --git a/webcit-ng/README.txt b/webcit-ng/README.txt
deleted file mode 100644 (file)
index ee5f5f3..0000000
+++ /dev/null
@@ -1,40 +0,0 @@
-
-
-This is WebCit-NG, a complete refactoring of the WebCit server that will
-focus on "REST first" and build around that.  The code will be well
-layered with as little spaghetti as possible.
-
-Please don't mess with this yet.  I'm only pushing it upstream so it gets backed up.
-
-Yes, I know the Makefile is built in a way that forces it to recompile everything
-when you touch even one file.  For the time being this is acceptable.
-
-
-DESIGN GOALS
-------------
-
-*      Hold as little state as possible
-
-*      Require NO cleanup.   Killing the process lets the OS reclaim all resources.
-
-*      As much as possible, resources should be freed by just coming back down the stack.
-       Avoid global variables and thread-local variables as much as possible.
-
-*      Readability of the code is more important than shaving off a few CPU cycles.
-
-*      Throw sensitive data such as passwords back and forth in clear text.
-       If you want privacy, encrypt the whole session.  Anything else is false security.
-
-
-
-
-REST format URLs will generally take the form of:
-
-       /ctdl/objectClass/[container/]object[/operation]
-
-We are using
-------------
-
-*      libcitadel for information about the Citadel server, some string handling, and the JSON encoder
-*      Expat for DAV handling
-*      OpenSSL for TLS