diff --git a/src/net/sourceforge/plantuml/activitydiagram/README.md b/src/net/sourceforge/plantuml/activitydiagram/README.md
new file mode 100644
index 000000000..a7b11e6c4
--- /dev/null
+++ b/src/net/sourceforge/plantuml/activitydiagram/README.md
@@ -0,0 +1,18 @@
+# Directory Documentation for `activitydiagram`
+
+## Description
+This package provides classes used to manage [Activity Diagram (legacy)](https://plantuml.com/activity-diagram-legacy)
+
+For new syntax see [`activitydiagram3`](./activitydiagram3)
+and [Activity Diagram (New Syntax)](https://plantuml.com/activity-diagram-beta)
+
+## Link
+- [Activity Diagram (legacy)](https://plantuml.com/activity-diagram-legacy)
+- [Activity Diagram (New Syntax)](https://plantuml.com/activity-diagram-beta)
+
+## Reference
+
+## Credit
+
+## Misc.
+