Merge pull request #1549 from The-Lum/ImproveDoc

docs: first commit in order to improve doc (JavaDoc, GH)

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;

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)

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;

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.