diff --git a/src/net/sourceforge/plantuml/activitydiagram/package-info.java b/src/net/sourceforge/plantuml/activitydiagram/package-info.java
new file mode 100644
index 000000000..219b26543
--- /dev/null
+++ b/src/net/sourceforge/plantuml/activitydiagram/package-info.java
@@ -0,0 +1,12 @@
+/**
+ * Provides classes used to manage 
+ * <a href="https://plantuml.com/activity-diagram-legacy" target="_top">
+ * Activity Diagram (legacy)</a>.
+ *
+ * <p>
+ * For new syntax see {@link net/sourceforge/plantuml/activitydiagram3}
+ * and 
+ * <a href="https://plantuml.com/activity-diagram-beta" target="_top">
+ * Activity Diagram (New Syntax)</a>.
+ */
+package net.sourceforge.plantuml.activitydiagram;
diff --git a/src/net/sourceforge/plantuml/activitydiagram/readme.md b/src/net/sourceforge/plantuml/activitydiagram/readme.md
index ab465bb7c..90b7ac262 100644
--- a/src/net/sourceforge/plantuml/activitydiagram/readme.md
+++ b/src/net/sourceforge/plantuml/activitydiagram/readme.md
@@ -1,10 +1,10 @@
 # Directory Documentation for `activitydiagram`
 
 ## Description
-This package provides classes used to manage [Activity Diagram (legacy)](https://plantuml.com/activity-diagram-legacy)
+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)
+and [Activity Diagram (New Syntax)](https://plantuml.com/activity-diagram-beta).
 
 ## Link
 - [Activity Diagram (legacy)](https://plantuml.com/activity-diagram-legacy)
diff --git a/src/net/sourceforge/plantuml/activitydiagram3/package-info.java b/src/net/sourceforge/plantuml/activitydiagram3/package-info.java
new file mode 100644
index 000000000..715b4c146
--- /dev/null
+++ b/src/net/sourceforge/plantuml/activitydiagram3/package-info.java
@@ -0,0 +1,6 @@
+/**
+ * Provides classes used to manage 
+ * <a href="https://plantuml.com/activity-diagram-beta" target="_top">
+ * Activity Diagram (New Syntax)</a>.
+ */
+package net.sourceforge.plantuml.activitydiagram3;
diff --git a/src/net/sourceforge/plantuml/activitydiagram3/readme.md b/src/net/sourceforge/plantuml/activitydiagram3/readme.md
new file mode 100644
index 000000000..10675561b
--- /dev/null
+++ b/src/net/sourceforge/plantuml/activitydiagram3/readme.md
@@ -0,0 +1,13 @@
+# Directory Documentation for `activitydiagram3`
+
+## Description
+This package provides classes used to manage [Activity Diagram (New Syntax)](https://plantuml.com/activity-diagram-beta).
+
+## Link
+- [Activity Diagram (New Syntax)](https://plantuml.com/activity-diagram-beta)
+
+## Reference
+
+## Credit
+
+## Misc.