Documentation is your friend

If you are a good developer you know the value of documentation. Anything you write should not be cryptic or only be understood by you. Let it be a Java, .NET, C++ project, or a Maven project—the documentation is your friend. A code with a good documentation is extremely readable. If any configuration you add into an application POM file is not self-descriptive, make sure you add at least a single line comment explaining what it does.

Here to follow some good examples from the Apache Axis2 project:

<profile>             
  <id>java16</id>             
  <activation>                 
    <jdk>1.6</jdk>             
  </activation>             
  <!-- JDK 1.6 build still use JAX-WS 2.1 because integrating 
       Java endorsed mechanism with Maven is bit of complex -  
  ->               
  <properties>                 
    <jaxb.api.version>2.1</jaxb.api.version>
    <jaxbri.version>2.1.7&lt...