You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@turbine.apache.org by jv...@apache.org on 2002/02/24 15:57:17 UTC
cvs commit: jakarta-turbine-maven/xdocs goals.xml

jvanzyl     02/02/24 06:57:17

  Added:       xdocs    goals.xml
  Log:
  - starting to codify the goals of maven, start with the easy one. the one
    that has some great books that can be used for support material: all of
    edward r. tufte's books.
  
  Revision  Changes    Path
  1.1                  jakarta-turbine-maven/xdocs/goals.xml
  
  Index: goals.xml
  ===================================================================
  <?xml version="1.0"?>
  <document>
  
    <properties>
      <author email="jason@zenplex.com">Jason van Zyl</author>
      <title>Maven's Goals</title>
    </properties>
  
    <body>
      <section name="Maven's Goals">
        <p>
          Maven's primary goal is to allow a developer to comprehend the
          complete state of a development effort in the short period of time.
        </p>
          
        <p>
          In order to aid in that comprehension, it will be necessary to not
          only produce metrics for the source base in question but to provide
          a terse graphical representation of the state of development. The
          following is an excerpt from the beginning of Edward R. Tufte's
          book <i>The Visual Display of Quantitative Information</i>:
        </p>
      
        <p>
          Excellence in statistical graphics consists of complex ideas
          communicated with clarity, precision, and efficiency. Graphical
          displays should:
        </p>
        
        <p>
          <li>
            show the data
          </li>
        
          <li>
            induce the viewer to think about the substance rather than about
            methodology, graphic design, the technology of graphic production,
            or something else
          </li>
        
          <li>
            avoid distorting what the data have to say
          </li>
          
          <li>
            present many numbers in a small space
          </li>
        
          <li>
            make large data sets coherent
          </li>
        
          <li>
            encourage the eye to compare different pieces of data
          </li>
        
          <li>
            reveal the data at several levels of detail, from a broad overview
            to the fine structure
          </li>          
        
          <li>
            serve a reasonably clear purpose: description, exploration, tabulation,
            or decoration
          </li>          
        
          <li>
            be closely integrated with the statistical and verbal descriptions of
            a data set.
          </li>
        </p>
      </section>
    </body>
  </document>
  
  
  

--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>