aboutsummaryrefslogtreecommitdiffstats
path: root/pydis_site/apps/staff/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'pydis_site/apps/staff/README.md')
-rw-r--r--pydis_site/apps/staff/README.md19
1 files changed, 19 insertions, 0 deletions
diff --git a/pydis_site/apps/staff/README.md b/pydis_site/apps/staff/README.md
new file mode 100644
index 00000000..6707bf26
--- /dev/null
+++ b/pydis_site/apps/staff/README.md
@@ -0,0 +1,19 @@
+# The "staff" app
+
+This Django application hosts any staff-internal tooling, which, at time of
+writing, is only an endpoint to view logs uploaded by the Python bot.
+
+This app mainly interacts with a single model from the `api` app, and has no
+models on its own. The following files and directories are of interest:
+
+- [`templatetags`](./templatetags) contains custom template tags that help with
+ formatting the HTML templates of this app (these can be found in the template
+ root direcetory).
+
+- [`tests`](./tests) contains standard Django unit tests that validate both the
+ template tags and functionality of the log viewer itself.
+
+- [`urls.py`](./urls.py) contains the regular Django URL routing logic.
+
+- [`views.py`](./views.py) contains standard Django views. In our case, the
+ main work happens in the template, so this is relatively straightforward.