diff --git a/include/ircd/m/resource.h b/include/ircd/m/resource.h
index 84e7ca2a1..6cbb034e5 100644
--- a/include/ircd/m/resource.h
+++ b/include/ircd/m/resource.h
@@ -16,6 +16,7 @@ namespace ircd::m
 	struct resource;
 }
 
+/// Extension of the ircd::resource framework for matrix resource handlers.
 struct ircd::m::resource
 :ircd::resource
 {
diff --git a/include/ircd/resource/method.h b/include/ircd/resource/method.h
index 8cedd09c1..1ea1f1d05 100644
--- a/include/ircd/resource/method.h
+++ b/include/ircd/resource/method.h
@@ -41,9 +41,9 @@ struct ircd::resource::method
 enum ircd::resource::method::flag
 :uint
 {
-	REQUIRES_AUTH         = 0x01,
+	REQUIRES_AUTH         = 0x01,   //TODO: matrix abstraction bleed.
 	RATE_LIMITED          = 0x02,
-	VERIFY_ORIGIN         = 0x04,
+	VERIFY_ORIGIN         = 0x04,   //TODO: matrix abstraction bleed.
 	CONTENT_DISCRETION    = 0x08,
 };