Index: /trunk/presets/presets.xml
===================================================================
--- /trunk/presets/presets.xml	(revision 1757)
+++ /trunk/presets/presets.xml	(revision 1758)
@@ -42,4 +42,12 @@
   delete_if_empty: true/false
 
+For external files the <annotations> should have following elements:
+- author           the author of the preset
+- version          a version number of some sort (e.g. creation date)
+- description      what is your preset meant to be
+- shortdescription very short description
+- link             a link to a helpful website (optional)
+- The fields description, shortdescription and link may also be localized (e.g. de.link)
+
 See also http://josm.openstreetmap.de/wiki/TaggingPresets.
 -->
Index: /trunk/styles/standard/elemstyles.xml
===================================================================
--- /trunk/styles/standard/elemstyles.xml	(revision 1757)
+++ /trunk/styles/standard/elemstyles.xml	(revision 1758)
@@ -48,4 +48,15 @@
 If a key/value pair matches more than one rule, the "rule that wins" is unpredicted
 in case they have same priority! Using priority settings helps to solve conflicts.
+
+For external files the <rules> should have following elements:
+- author           the author of the style
+- version          a version number of some sort (e.g. creation date)
+- description      what is your style meant to be
+- shortdescription very short description
+- link             a link to a helpful website (optional)
+- The fields description, shortdescription and link may also be localized (e.g. de.link)
+- name             is the name of the style
+                   - when the style replaces the whole rendering choose a new name
+                   - when the style is additional choose "standard" or don't use name tag
 -->