From 2f699caf44ca3eb395c087ed3f1e7d6f2bc69167 Mon Sep 17 00:00:00 2001
From: Jeremy Dormitzer <jeremy.dormitzer@gmail.com>
Date: Wed, 22 Aug 2018 08:33:21 -0400
Subject: [PATCH] Take some notes on inbox and outbox

---
 inc/inbox.php  | 6 ++++++
 inc/outbox.php | 9 +++++++++
 2 files changed, 15 insertions(+)

diff --git a/inc/inbox.php b/inc/inbox.php
index 62a2de0..d2804b5 100644
--- a/inc/inbox.php
+++ b/inc/inbox.php
@@ -1,3 +1,9 @@
 <?php
+/*
+When an Activity is received (i.e. POSTed) to an Actor's inbox, the server must:
 
+  1. Forward the Activity as necessary
+       See (https://www.w3.org/TR/activitypub/#x7-1-2-forwarding-from-inbox).
+  2. Perform the side effects of receiving the Activity
+*/
 ?>
diff --git a/inc/outbox.php b/inc/outbox.php
index 62a2de0..d29fc1e 100644
--- a/inc/outbox.php
+++ b/inc/outbox.php
@@ -1,3 +1,12 @@
 <?php
+/*
+When an Activity is received (i.e. POSTed) to an Actor's outbox, the server must:
 
+  1. Add the Activity to the Actor's outbox collection in the DB
+  2. Deliver the Activity to the appropriate inboxes based on the received Activity
+       This involves discovering all the inboxes, including nested ones if the target
+       is a collection, deduplicating inboxes, and the POSTing the Activity to each
+       target inbox.
+  3. Perform side effects as necessary
+*/
 ?>