creadur-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rdon...@apache.org
Subject svn commit: r1367273 - in /creadur/whisker/trunk/src/site: apt/examples/in-5-mins.apt fml/faq.fml
Date Mon, 30 Jul 2012 20:30:25 GMT
Author: rdonkin
Date: Mon Jul 30 20:30:25 2012
New Revision: 1367273

URL: http://svn.apache.org/viewvc?rev=1367273&view=rev
Log:
Added FAQ about selecting name for license

Modified:
    creadur/whisker/trunk/src/site/apt/examples/in-5-mins.apt
    creadur/whisker/trunk/src/site/fml/faq.fml

Modified: creadur/whisker/trunk/src/site/apt/examples/in-5-mins.apt
URL: http://svn.apache.org/viewvc/creadur/whisker/trunk/src/site/apt/examples/in-5-mins.apt?rev=1367273&r1=1367272&r2=1367273&view=diff
==============================================================================
--- creadur/whisker/trunk/src/site/apt/examples/in-5-mins.apt (original)
+++ creadur/whisker/trunk/src/site/apt/examples/in-5-mins.apt Mon Jul 30 20:30:25 2012
@@ -70,7 +70,7 @@ Whisker In 5 Minutes
   Each license, notice and organisation is described once 
   above, and then
   {{{../faq.html#why-ids}referenced by id}} below.
-  Begin with an outline.
+  Start with the outline.
  
 +---------------------------------------+
 <manifest>
@@ -96,7 +96,8 @@ Whisker In 5 Minutes
   by id}}. 
   
   This project is MIT licensed, so a description of this license 
-  needs to be added into <<<licenses>>>. 
+  needs to be added into <<<licenses>>>. Choose a <<<name>>>
suitable
+  for {{{../faq.html#name-freedom}display}}. 
   
 +---------------------------------------+
 <manifest>

Modified: creadur/whisker/trunk/src/site/fml/faq.fml
URL: http://svn.apache.org/viewvc/creadur/whisker/trunk/src/site/fml/faq.fml?rev=1367273&r1=1367272&r2=1367273&view=diff
==============================================================================
--- creadur/whisker/trunk/src/site/fml/faq.fml (original)
+++ creadur/whisker/trunk/src/site/fml/faq.fml Mon Jul 30 20:30:25 2012
@@ -42,6 +42,25 @@ but otherwise you are free. 
       </p>
       </answer>
     </faq>
+    <faq id="name-freedom">
+      <question>Am I Free to Pick Any Name?</question>
+      <answer>
+      <p>
+      Yes, but...
+      </p>
+      <p>
+Whisker adopts the convention that <code>name</code> attributes 
+(for example, on <code>license</code> elements) are used
+for presentation, so it is strong recommended that a suitably
+human-readable title is chosen. 
+      </p>
+      <p>
+Where possibly, pick the standard name for this license: either the
+title within the text, or the name adopted by a standards organisation 
+for example  <a href='http://www.opensource.org'>The Open Source Initiative</a>.
+      </p>
+      </answer>
+    </faq>
     <faq id='where-is-reference'>
         <question>Is a reference available?</question>
         <answer>



Mime
View raw message