diff --git a/pages/docs/using.md b/pages/docs/using.md
index 87d91925f1fdd176faa57f724193dd24a1f5accc..5854d4708679dd27af9036336d039b0d2bb3bf8f 100644
--- a/pages/docs/using.md
+++ b/pages/docs/using.md
@@ -244,3 +244,14 @@ assertEquals(receiverRoot.getAList(), list("1", "other"));
 // after receiving "new" on topic "some/topic/one"
 assertEquals(receiverRoot.getAList(), list("1", "other", "new"));
 ```
+
+## Using attributes as endpoint targets
+
+As described in the [DSL specification](/dsl), attributes can be used as endpoint targets.
+They can only be used in send endpoints, and the return type of the attribute must be specified in the connect specification (because aspect files are not handled completely yet).
+
+Currently, synthesized, inherited, collection, and circular attributes are supported.
+Nonterminal attributes are best used with the "legacy" notation `/Context:Type/` within the grammar.
+
+Please note, that serialization of Java collections of nonterminals is not supported, e.g., a `java.util.Set<ASTNode>`.
+Only list nodes as defined in the grammar `/Context:Type*/` are properly recognized.