diff --git a/lib/public/AppFramework/HttpContext.php b/lib/public/AppFramework/HttpContext.php
index c8d5d9552024d..7c6dfdaceffa5 100644
--- a/lib/public/AppFramework/HttpContext.php
+++ b/lib/public/AppFramework/HttpContext.php
@@ -19,6 +19,10 @@
 use OCP\AppFramework\Http\Response;
 use OCP\IRequest;
 
+/**
+ * Class representing context available in middlewares during request processing
+ * @since 17.0.0
+ */
 class HttpContext {
 	/** @var IRequest */
 	public $request;
diff --git a/lib/public/AppFramework/Middleware.php b/lib/public/AppFramework/Middleware.php
index 5406bd8cc7700..b86745f4a31ca 100644
--- a/lib/public/AppFramework/Middleware.php
+++ b/lib/public/AppFramework/Middleware.php
@@ -45,6 +45,11 @@ abstract class Middleware {
 
 	protected $context;
 
+	/**
+	 * This method is called before processing request
+	 * @param HttpContext $context the context of the currently processed request
+	 * @since 17.0.0
+	 */
 	public function setContext(HttpContext $context) {
 		$this->context = $context;
 	}