Index: /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/actions/package-info.java
===================================================================
--- /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/actions/package-info.java	(revision 31814)
+++ /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/actions/package-info.java	(revision 31814)
@@ -0,0 +1,6 @@
+/**
+ * Actions that are normally attached to a button or a menu item and are then executed
+ * to manipulate the {@link org.openstreetmap.josm.plugins.mapillary.MapillaryLayer} when
+ * the button is clicked.
+ */
+package org.openstreetmap.josm.plugins.mapillary.actions;
Index: /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/cache/package-info.java
===================================================================
--- /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/cache/package-info.java	(revision 31814)
+++ /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/cache/package-info.java	(revision 31814)
@@ -0,0 +1,6 @@
+/**
+ * This package is all about caching resources downloaded from
+ * <a href="https://mapillary.com">mapillary.com</a>
+ * for faster access to those resources in the future.
+ */
+package org.openstreetmap.josm.plugins.mapillary.cache;
Index: /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/gui/package-info.java
===================================================================
--- /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/gui/package-info.java	(revision 31814)
+++ /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/gui/package-info.java	(revision 31814)
@@ -0,0 +1,4 @@
+/**
+ * The GUI components that are special to the mapillary plugin.
+ */
+package org.openstreetmap.josm.plugins.mapillary.gui;
Index: /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/history/commands/package-info.java
===================================================================
--- /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/history/commands/package-info.java	(revision 31814)
+++ /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/history/commands/package-info.java	(revision 31814)
@@ -0,0 +1,4 @@
+/**
+ * The commands that the user can execute, which are recorded in the undo/redo-log.
+ */
+package org.openstreetmap.josm.plugins.mapillary.history.commands;
Index: /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/history/package-info.java
===================================================================
--- /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/history/package-info.java	(revision 31814)
+++ /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/history/package-info.java	(revision 31814)
@@ -0,0 +1,5 @@
+/**
+ * This package deals with keeping a history of actions the user performed
+ * to allow for undoing and redoing these actions.
+ */
+package org.openstreetmap.josm.plugins.mapillary.history;
Index: /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/io/download/package-info.java
===================================================================
--- /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/io/download/package-info.java	(revision 31814)
+++ /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/io/download/package-info.java	(revision 31814)
@@ -0,0 +1,4 @@
+/**
+ * Classes for downloading images, sequences and image metadata like traffic signs from <a href="https://mapillary.com">mapillary.com</a> .
+ */
+package org.openstreetmap.josm.plugins.mapillary.io.download;
Index: /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/io/export/package-info.java
===================================================================
--- /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/io/export/package-info.java	(revision 31814)
+++ /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/io/export/package-info.java	(revision 31814)
@@ -0,0 +1,4 @@
+/**
+ * Classes for exporting images that were downloaded from <a href="https://mapillary.com">mapillary.com</a> .
+ */
+package org.openstreetmap.josm.plugins.mapillary.io.export;
Index: /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/io/package-info.java
===================================================================
--- /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/io/package-info.java	(revision 31814)
+++ /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/io/package-info.java	(revision 31814)
@@ -0,0 +1,4 @@
+/**
+ * Classes for I/O operations like downloading images and their metadata and exporting them.
+ */
+package org.openstreetmap.josm.plugins.mapillary.io;
Index: /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/mode/package-info.java
===================================================================
--- /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/mode/package-info.java	(revision 31814)
+++ /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/mode/package-info.java	(revision 31814)
@@ -0,0 +1,11 @@
+/**
+ * The different modes that the {@link org.openstreetmap.josm.plugins.mapillary.MapillaryLayer} can be in.
+ * <p>
+ *   Currently there are two of them:
+ *   <ul>
+ *    <li><strong>{@link org.openstreetmap.josm.plugins.mapillary.mode.JoinMode}</strong> for joining pictures to make sequences</li>
+ *    <li><strong>{@link org.openstreetmap.josm.plugins.mapillary.mode.SelectMode}</strong> for selecting pictures in the layer</li>
+ *   </ul>
+ * </p>
+ */
+package org.openstreetmap.josm.plugins.mapillary.mode;
Index: /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/oauth/package-info.java
===================================================================
--- /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/oauth/package-info.java	(revision 31814)
+++ /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/oauth/package-info.java	(revision 31814)
@@ -0,0 +1,6 @@
+/**
+ * Everything related to signing users in and out of Mapillary.
+ * We are using OAuth 2.0 to authenticate the user against the Mapillary API.
+ * See https://a.mapillary.com/#oauth for more details.
+ */
+package org.openstreetmap.josm.plugins.mapillary.oauth;
Index: /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/package-info.java
===================================================================
--- /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/package-info.java	(revision 31814)
+++ /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/package-info.java	(revision 31814)
@@ -0,0 +1,4 @@
+/**
+ * The main package in which all core-code (so at the moment all code) resides.
+ */
+package org.openstreetmap.josm.plugins.mapillary;
Index: /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/traffico/package-info.java
===================================================================
--- /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/traffico/package-info.java	(revision 31814)
+++ /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/traffico/package-info.java	(revision 31814)
@@ -0,0 +1,5 @@
+/**
+ * Components for painting traffic signs with the help of the traffico icon font.
+ * See http://traffico.io and https://github.com/mapillary/traffico for more info on traffico.
+ */
+package org.openstreetmap.josm.plugins.mapillary.traffico;
Index: /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/utils/package-info.java
===================================================================
--- /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/utils/package-info.java	(revision 31814)
+++ /applications/editors/josm/plugins/mapillary/src/org/openstreetmap/josm/plugins/mapillary/utils/package-info.java	(revision 31814)
@@ -0,0 +1,5 @@
+/**
+ * Utility classes for simplifying recurring tasks throughout the project.
+ * These classes are typically not instantiatable and only have static methods.
+ */
+package org.openstreetmap.josm.plugins.mapillary.utils;