You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tapestry.apache.org by bu...@apache.org on 2015/07/19 23:21:30 UTC
svn commit: r958985 [11/29] - in /websites/production/tapestry/content: ./
2009/09/13/ 2009/10/27/ 2009/11/25/ 2010/07/18/ 2010/07/24/ 2010/10/11/
2010/10/31/ 2010/11/18/ 2010/12/16/ 2010/12/17/ 2011/01/18/ 2011/03/23/
2011/03/29/ 2011/03/30/ 2011/03/3...
Modified: websites/production/tapestry/content/documentation-improvement-tasks.html
==============================================================================
--- websites/production/tapestry/content/documentation-improvement-tasks.html (original)
+++ websites/production/tapestry/content/documentation-improvement-tasks.html Sun Jul 19 21:21:27 2015
@@ -27,6 +27,16 @@
</title>
<link type="text/css" rel="stylesheet" href="/resources/space.css">
+ <link href='/resources/highlighter/styles/shCoreCXF.css' rel='stylesheet' type='text/css' />
+ <link href='/resources/highlighter/styles/shThemeCXF.css' rel='stylesheet' type='text/css' />
+ <script src='/resources/highlighter/scripts/shCore.js' type='text/javascript'></script>
+ <script src='/resources/highlighter/scripts/shBrushJava.js' type='text/javascript'></script>
+ <script src='/resources/highlighter/scripts/shBrushXml.js' type='text/javascript'></script>
+ <script src='/resources/highlighter/scripts/shBrushPlain.js' type='text/javascript'></script>
+ <script type="text/javascript">
+ SyntaxHighlighter.defaults['toolbar'] = false;
+ SyntaxHighlighter.all();
+ </script>
<link href="/styles/style.css" rel="stylesheet" type="text/css"/>
@@ -65,1031 +75,48 @@
<div class="confluence-information-macro confluence-information-macro-note"><span class="aui-icon aui-icon-small aui-iconfont-warning confluence-information-macro-icon"></span><div class="confluence-information-macro-body">
<p>These are merely suggestions from Tapestry users. Some might be bad ideas. Consider carefully which of these ought to be done and how, and start a discussion on the dev mailing list about any change that could be controversial.</p></div></div>
-
-
-
-
-
-
-
-
-<fieldset class="hidden parameters">
- <input type="hidden" id="1:_baseUri" value="/confluence">
- <input type="hidden" id="1:_entityId" value="24187927">
-
- <input type="hidden" id="1:_readOnly" value="true">
- <input type="hidden" id="1:_enableLocking" value="false">
- <input type="hidden" id="1:_sort" value="">
- <input type="hidden" id="1:_sortAscending" value="true">
- <input type="hidden" id="1:_promptOnDelete" value="true">
- <input type="hidden" class="plugin_tasklist_i18n" id="1:_i18n_taskdeletemessage" name="i18n-taskdeletemessage" value="Are you sure to delete {0}?">
- <input type="hidden" name="baseUrl" value="https://cwiki.apache.org/confluence">
-</fieldset>
-
-<div class="task-list" id="1:_hook">
-
-
-
-
-
-<div class="progress">
- <div style="width: 15%">15%</div>
-</div>
- <h3>
- Task List
- </h3>
-<ol class="tasklist-container" id="tasklist-1:"><li class="closed task with high priority" id="1:_p2107937109_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input disabled>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- Need more cross-linking between the wiki pages, especially between FAQ pages, User Guide pages, Cheat Sheet pages and Cookbook pages that cover the same topic.
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">HIGH</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only"></span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">N/A</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_p2107937109</span>
- <span class="task-name">Need more cross-linking between the wiki pages, especially between FAQ pages, User Guide pages, Cheat Sheet pages and Cookbook pages that cover the same topic.</span>
- <span class="task-priority">HIGH</span>
- <span class="task-createdDate">0</span>
- <span class="task-completed">false</span>
- <span class="task-completedDate">0</span>
- <span class="task-locked">false</span>
- <span class="task-assginee"></span>
- </div>
-
- </form>
-</li><li class="closed task with medium priority" id="1:_n1448724216_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input disabled>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- <a shape="rect" href="component-cheat-sheet.html" title="Component Cheat Sheet">Component Cheat Sheet</a> should have, for each of the listed annotations, a link to the corresponding API page.
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">MEDIUM</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only"></span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">N/A</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_n1448724216</span>
- <span class="task-name">[Component Cheat Sheet] should have, for each of the listed annotations, a link to the corresponding API page.</span>
- <span class="task-priority">MEDIUM</span>
- <span class="task-createdDate">0</span>
- <span class="task-completed">false</span>
- <span class="task-completedDate">0</span>
- <span class="task-locked">false</span>
- <span class="task-assginee"></span>
- </div>
-
- </form>
-</li><li class="closed task with medium priority" id="1:_n1116189753_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input disabled>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- Some pages don't link to all of their child pages
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">MEDIUM</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only"></span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">N/A</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_n1116189753</span>
- <span class="task-name">Some pages don\'t link to all of their child pages</span>
- <span class="task-priority">MEDIUM</span>
- <span class="task-createdDate">0</span>
- <span class="task-completed">false</span>
- <span class="task-completedDate">0</span>
- <span class="task-locked">false</span>
- <span class="task-assginee"></span>
- </div>
-
- </form>
-</li><li class="closed task with medium priority" id="1:_n2018629363_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input disabled>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- Move some of the best MoinMoin wiki content into Confluence?
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">MEDIUM</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only"></span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">N/A</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_n2018629363</span>
- <span class="task-name">Move some of the best MoinMoin wiki content into Confluence?</span>
- <span class="task-priority">MEDIUM</span>
- <span class="task-createdDate">0</span>
- <span class="task-completed">false</span>
- <span class="task-completedDate">0</span>
- <span class="task-locked">false</span>
- <span class="task-assginee"></span>
- </div>
-
- </form>
-</li><li class="closed task with medium priority" id="1:_n1648697673_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input disabled>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- Need an article on clustering & high availability, then link to it from the clustering sections of <a shape="rect" href="persistent-page-data.html" title="Persistent Page Data">Persistent Page Data</a>, <a shape="rect" href="ioc-serialization.html" title="IoC - serialization">IoC - serialization</a>, <a shape="rect" href="persistent-state.html" title="Persistent State">Persistent State</a>, <a shape="rect" href="https.html" title="HTTPS">HTTPS</a>, and other pages that mention clustering
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">MEDIUM</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only"></span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">Nov 27, 2010</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_n1648697673</span>
- <span class="task-name">Need an article on clustering & high availability, then link to it from the clustering sections of [Persistent Page Data], [IoC - serialization], [Persistent State], [HTTPS], and other pages that mention clustering</span>
- <span class="task-priority">MEDIUM</span>
- <span class="task-createdDate">1290869296693</span>
- <span class="task-completed">false</span>
- <span class="task-completedDate">0</span>
- <span class="task-locked">false</span>
- <span class="task-assginee"></span>
- </div>
-
- </form>
-</li><li class="closed task with medium priority" id="1:_n1889994418_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input disabled>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- Need a "Support" page that lists support options. This is where the mailing lists should be mentioned., as well as Howard's trainig, etc
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">MEDIUM</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only"></span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">Nov 27, 2010</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_n1889994418</span>
- <span class="task-name">Need a \"Support\" page that lists support options. This is where the mailing lists should be mentioned., as well as Howard\'s trainig, etc</span>
- <span class="task-priority">MEDIUM</span>
- <span class="task-createdDate">1290869418470</span>
- <span class="task-completed">false</span>
- <span class="task-completedDate">0</span>
- <span class="task-locked">false</span>
- <span class="task-assginee"></span>
- </div>
-
- </form>
-</li><li class="closed task with medium priority" id="1:_n1823905030_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input disabled>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- The links to "Tapestry Home" in the breadcrums on pages like <a shape="rect" href="tutorial.html" title="Tutorial">Tutorial</a> link to the "Home" page but should link to the index.html page
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">MEDIUM</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only"></span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">Nov 27, 2010</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_n1823905030</span>
- <span class="task-name">The links to \"Tapestry Home\" in the breadcrums on pages like [Tutorial] link to the \"Home\" page but should link to the index.html page</span>
- <span class="task-priority">MEDIUM</span>
- <span class="task-createdDate">1290872794706</span>
- <span class="task-completed">false</span>
- <span class="task-completedDate">0</span>
- <span class="task-locked">false</span>
- <span class="task-assginee"></span>
- </div>
-
- </form>
-</li><li class="closed task with medium priority" id="1:_n821247703_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input disabled>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- Make it more obvious how to contribute to documentation improvements
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">MEDIUM</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only"></span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">Nov 27, 2010</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_n821247703</span>
- <span class="task-name">Make it more obvious how to contribute to documentation improvements</span>
- <span class="task-priority">MEDIUM</span>
- <span class="task-createdDate">1290872892940</span>
- <span class="task-completed">false</span>
- <span class="task-completedDate">0</span>
- <span class="task-locked">false</span>
- <span class="task-assginee"></span>
- </div>
-
- </form>
-</li><li class="completed closed task with medium priority" id="1:_p2024835349_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input checked>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- in the "create your first tapestry project" tutorial, don't make the user choose an archetype or a tapestry version. Write the instructions for the latest stable version. It's better to have that be out of date when a new version comes out (because it still will work) than have the user decide at this stage. Same for the groupId, artifactId, version and package. It's a test project the user is creating, those values are not going to matter. Give the defaults so people can copy and paste the command and have the project created, built and run.
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">MEDIUM</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only">javier@anatomicsoft.com</span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">Nov 27, 2010</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_p2024835349</span>
- <span class="task-name">in the \"create your first tapestry project\" tutorial, don\'t make the user choose an archetype or a tapestry version. Write the instructions for the latest stable version. It\'s better to have that be out of date when a new version comes out (because it still will work) than have the user decide at this stage. Same for the groupId, artifactId, version and package. It\'s a test project the user is creating, those values are not going to matter. Give the defaults so people can copy and paste the command and have the project created, built and run.</span>
- <span class="task-priority">MEDIUM</span>
- <span class="task-createdDate">1290873286462</span>
- <span class="task-completed">true</span>
- <span class="task-completedDate">1291053687265</span>
- <span class="task-locked">false</span>
- <span class="task-assginee">javier@anatomicsoft.com</span>
- </div>
-
- </form>
-</li><li class="completed closed task with medium priority" id="1:_n365989630_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input checked>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- After the test project has been created, give the user some pointers on where to find things (pages go in src/main/java/com/example/pages, page templates go in webapp). Although there is a link to the tutorial, if this first experience is too frustrating, people might not even bother to go there.
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">MEDIUM</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only">javier@anatomicsoft.com</span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">Nov 27, 2010</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_n365989630</span>
- <span class="task-name">After the test project has been created, give the user some pointers on where to find things (pages go in src/main/java/com/example/pages, page templates go in webapp). Although there is a link to the tutorial, if this first experience is too frustrating, people might not even bother to go there.</span>
- <span class="task-priority">MEDIUM</span>
- <span class="task-createdDate">1290873334655</span>
- <span class="task-completed">true</span>
- <span class="task-completedDate">1291036593723</span>
- <span class="task-locked">false</span>
- <span class="task-assginee">javier@anatomicsoft.com</span>
- </div>
-
- </form>
-</li><li class="closed task with medium priority" id="1:_p447986293_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input disabled>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- add something to the archetype with commented out code that the user can uncomment and see something cool happen. It has to be a few lines only, to be easily understandable, and clearly link components in the template with their methods in the page class.
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">MEDIUM</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only"></span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">Nov 27, 2010</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_p447986293</span>
- <span class="task-name">add something to the archetype with commented out code that the user can uncomment and see something cool happen. It has to be a few lines only, to be easily understandable, and clearly link components in the template with their methods in the page class.</span>
- <span class="task-priority">MEDIUM</span>
- <span class="task-createdDate">1290873345788</span>
- <span class="task-completed">false</span>
- <span class="task-completedDate">0</span>
- <span class="task-locked">false</span>
- <span class="task-assginee"></span>
- </div>
-
- </form>
-</li><li class="closed task with medium priority" id="1:_n1255341842_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input disabled>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- the tapestry tutorial starts unnecessarily verbose about topics not really related to me getting code running and out the door. Strip it to the essentials. If you want to mention Struts and the Servlet API compared to the tapestry way, mention them in a separate chapter so they are easy to find / skip as needed.
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">MEDIUM</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only"></span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">Nov 27, 2010</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_n1255341842</span>
- <span class="task-name">the tapestry tutorial starts unnecessarily verbose about topics not really related to me getting code running and out the door. Strip it to the essentials. If you want to mention Struts and the Servlet API compared to the tapestry way, mention them in a separate chapter so they are easy to find / skip as needed.</span>
- <span class="task-priority">MEDIUM</span>
- <span class="task-createdDate">1290873360243</span>
- <span class="task-completed">false</span>
- <span class="task-completedDate">0</span>
- <span class="task-locked">false</span>
- <span class="task-assginee"></span>
- </div>
-
- </form>
-</li><li class="closed task with medium priority" id="1:_p398439158_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input disabled>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- there is no table of contents for the tutorial and no indication of how long it takes to complete
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">MEDIUM</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only"></span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">Nov 27, 2010</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_p398439158</span>
- <span class="task-name">there is no table of contents for the tutorial and no indication of how long it takes to complete</span>
- <span class="task-priority">MEDIUM</span>
- <span class="task-createdDate">1290873372769</span>
- <span class="task-completed">false</span>
- <span class="task-completedDate">0</span>
- <span class="task-locked">false</span>
- <span class="task-assginee"></span>
- </div>
-
- </form>
-</li><li class="closed task with medium priority" id="1:_n758752520_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input disabled>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- There are too many callouts, warnings and decorations in the tutorial. It is very distracting visually and that makes it hard to follow. It's impossible to scan the pages to get a feel for what you've got ahead of you.
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">MEDIUM</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only"></span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">Nov 27, 2010</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_n758752520</span>
- <span class="task-name">There are too many callouts, warnings and decorations in the tutorial. It is very distracting visually and that makes it hard to follow. It\'s impossible to scan the pages to get a feel for what you\'ve got ahead of you.</span>
- <span class="task-priority">MEDIUM</span>
- <span class="task-createdDate">1290873390989</span>
- <span class="task-completed">false</span>
- <span class="task-completedDate">0</span>
- <span class="task-locked">false</span>
- <span class="task-assginee"></span>
- </div>
-
- </form>
-</li><li class="closed task with medium priority" id="1:_n525483807_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input disabled>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- Add a page about testing your Tapestry app (not just testing of pages)
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">MEDIUM</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only"></span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">Nov 27, 2010</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_n525483807</span>
- <span class="task-name">Add a page about testing your Tapestry app (not just testing of pages)</span>
- <span class="task-priority">MEDIUM</span>
- <span class="task-createdDate">1290873483266</span>
- <span class="task-completed">false</span>
- <span class="task-completedDate">0</span>
- <span class="task-locked">false</span>
- <span class="task-assginee"></span>
- </div>
-
- </form>
-</li><li class="closed task with medium priority" id="1:_p1935153188_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input disabled>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- On the ComponentCheetSheet, add a sentance or two more on each annotation would be great.
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">MEDIUM</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only"></span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">Nov 27, 2010</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_p1935153188</span>
- <span class="task-name">On the ComponentCheetSheet, add a sentance or two more on each annotation would be great.</span>
- <span class="task-priority">MEDIUM</span>
- <span class="task-createdDate">1290873573643</span>
- <span class="task-completed">false</span>
- <span class="task-completedDate">0</span>
- <span class="task-locked">false</span>
- <span class="task-assginee"></span>
- </div>
-
- </form>
-</li><li class="completed closed task with medium priority" id="1:_p1821179239_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input checked>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- The tutorial Setting up your environment should be improved. Alternatives should be described on how to run T5 apps in the Eclipse or other IDEs, but not in the text as that would make it too long. I think there should be links for alternative setups - like how to run the T5 app from a main class and even start VisualVM for early debugging and optimizing (each alternative has pros and cons). There is no mention of m2eclipse plugin. Of course one can use JDK 6 also - only 1.5 is there. There is a sentence: "You should not have to download this directly". Why are then download links on the download page and no mention of maven at the same time. It is confusing for newbs.
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">MEDIUM</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only">bobharner</span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">Nov 27, 2010</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_p1821179239</span>
- <span class="task-name">The tutorial Setting up your environment should be improved. Alternatives should be described on how to run T5 apps in the Eclipse or other IDEs, but not in the text as that would make it too long. I think there should be links for alternative setups - like how to run the T5 app from a main class and even start VisualVM for early debugging and optimizing (each alternative has pros and cons). There is no mention of m2eclipse plugin. Of course one can use JDK 6 also - only 1.5 is there. There is a sentence: \"You should not have to download this directly\". Why are then download links on the download page and no mention of maven at the same time. It is confusing for newbs.</span>
- <span class="task-priority">MEDIUM</span>
- <span class="task-createdDate">1290873630472</span>
- <span class="task-completed">true</span>
- <span class="task-completedDate">1418608629709</span>
- <span class="task-locked">false</span>
- <span class="task-assginee">bobharner</span>
- </div>
-
- </form>
-</li><li class="closed task with medium priority" id="1:_p958230743_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input disabled>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- Add a link to JIRA in the About page
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">MEDIUM</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only"></span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">Nov 27, 2010</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_p958230743</span>
- <span class="task-name">Add a link to JIRA in the About page</span>
- <span class="task-priority">MEDIUM</span>
- <span class="task-createdDate">1290873682697</span>
- <span class="task-completed">false</span>
- <span class="task-completedDate">0</span>
- <span class="task-locked">false</span>
- <span class="task-assginee"></span>
- </div>
-
- </form>
-</li><li class="closed task with medium priority" id="1:_n224104183_hook">
- <form enctype="application/x-www-form-urlencoded" method="get" class="aui" action="#">
- <div class="task-actions">
- <div class="handle" title="drag me">handler</div>
- <div>
- <button type="button" class="trigger icon-section-closed">open/close</button>
- <div>
-
- <input disabled>
-
- <span class="priority-icon"></span>
- </div>
- </div>
- </div>
-
- <p class="rendered taskname">
- Resolve the TODO at the bottom of <a shape="rect" href="component-classes.html" title="Component Classes">Component Classes</a> ("May want a more complex check; what if user uses prop: in the template and there's a conflict?")
- </p>
-
- <div class="additional-info-adg">
- <fieldset class="group">
- <legend>
- <span>Priority</span>
- </legend>
- <span class="field-value read-only" id="task-priority-id">MEDIUM</span>
- </fieldset>
-
- <fieldset class="group">
- <div class="field-group">
- <label for="task-assignee">Assigned To</label>
- <span class="field-value read-only"></span>
- </div>
- </fieldset>
- <fieldset class="group">
- <div class="field-group viewMode">
- <label for="task-created" id="task-created-label">Created</label>
- <span class="field-value task-created-date" id="task-created">Nov 28, 2010</span>
- </div>
- </fieldset>
- </div>
- <div class="task-item hidden">
- <span class="task-id">1:_n224104183</span>
- <span class="task-name">Resolve the TODO at the bottom of [Component Classes] (\"May want a more complex check; what if user uses prop: in the template and there\'s a conflict?\")</span>
- <span class="task-priority">MEDIUM</span>
- <span class="task-createdDate">1290954416064</span>
- <span class="task-completed">false</span>
- <span class="task-completedDate">0</span>
- <span class="task-locked">false</span>
- <span class="task-assginee"></span>
- </div>
-
- </form>
-</li></ol>
-
-
-<div class="dtl-error" id="1:_error" style="height: 0; line-height: 0;"></div>
+<div style="background-color: #f9f9f9; border: 1px solid #c0c0c0; width: 40em;">
+ <h2></h2>
+ <h6>15% of the tasks completed</h6>
+ <table border="0" style="border-collapse: collapse; width: 100%;"><tbody><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input disabled></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%">Need more cross-linking between the wiki pages, especially between FAQ pages, User Guide pages, Cheat Sheet pages and Cookbook pages that cover the same topic.</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; text-align: right;">
+ High
+ </td></tr><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input disabled></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%"><a shape="rect" href="component-cheat-sheet.html" title="Component Cheat Sheet">Component Cheat Sheet</a> should have, for each of the listed annotations, a link to the corresponding API page.</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; text-align: right;">
+ Medium
+ </td></tr><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input disabled></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%">Some pages don't link to all of their child pages</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; text-align: right;">
+ Medium
+ </td></tr><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input disabled></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%">Move some of the best MoinMoin wiki content into Confluence?</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; text-align: right;">
+ Medium
+ </td></tr><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input disabled></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%">Need an article on clustering & high availability, then link to it from the clustering sections of <a shape="rect" href="persistent-page-data.html" title="Persistent Page Data">Persistent Page Data</a>, <a shape="rect" href="ioc-serialization.html" title="IoC - serialization">IoC - serialization</a>, <a shape="rect" href="persistent-state.html" title="Persistent State">Persistent State</a>, <a shape="rect" href="https.html" title="HTTPS">HTTPS</a>, and other pages that mention clustering</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; text-align: right;">
+ Medium
+ </td></tr><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input disabled></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%">Need a "Support" page that lists support options. This is where the mailing lists should be mentioned., as well as Howard's trainig, etc</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; text-align: right;">
+ Medium
+ </td></tr><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input disabled></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%">The links to "Tapestry Home" in the breadcrums on pages like <a shape="rect" href="tutorial.html" title="Tutorial">Tutorial</a> link to the "Home" page but should link to the index.html page</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; text-align: right;">
+ Medium
+ </td></tr><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input disabled></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%">Make it more obvious how to contribute to documentation improvements</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; text-align: right;">
+ Medium
+ </td></tr><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input checked></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%">in the "create your first tapestry project" tutorial, don't make the user choose an archetype or a tapestry version. Write the instructions for the latest stable version. It's better to have that be out of date when a new version comes out (because it still will work) than have the user decide at this stage. Same for the groupId, artifactId, version and package. It's a test project the user is creating, those values are not going to matter. Give the defaults so people can copy and paste the command and have the project created, built and run.</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; text-align: right;">
+ Medium
+ </td></tr><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input checked></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%">After the test project has been created, give the user some pointers on where to find things (pages go in src/main/java/com/example/pages, page templates go in webapp). Although there is a link to the tutorial, if this first experience is too frustrating, people might not even bother to go there.</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; text-align: right;">
+ Medium
+ </td></tr><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input disabled></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%">add something to the archetype with commented out code that the user can uncomment and see something cool happen. It has to be a few lines only, to be easily understandable, and clearly link components in the template with their methods in the page class.</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; text-align: right;">
+ Medium
+ </td></tr><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input disabled></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%">the tapestry tutorial starts unnecessarily verbose about topics not really related to me getting code running and out the door. Strip it to the essentials. If you want to mention Struts and the Servlet API compared to the tapestry way, mention them in a separate chapter so they are easy to find / skip as needed.</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; text-align: right;">
+ Medium
+ </td></tr><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input disabled></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%">there is no table of contents for the tutorial and no indication of how long it takes to complete</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; text-align: right;">
+ Medium
+ </td></tr><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input disabled></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%">There are too many callouts, warnings and decorations in the tutorial. It is very distracting visually and that makes it hard to follow. It's impossible to scan the pages to get a feel for what you've got ahead of you.</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; text-align: right;">
+ Medium
+ </td></tr><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input disabled></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%">Add a page about testing your Tapestry app (not just testing of pages)</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; text-align: right;">
+ Medium
+ </td></tr><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input disabled></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%">On the ComponentCheetSheet, add a sentance or two more on each annotation would be great.</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; text-align: right;">
+ Medium
+ </td></tr><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input checked></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%">The tutorial Setting up your environment should be improved. Alternatives should be described on how to run T5 apps in the Eclipse or other IDEs, but not in the text as that would make it too long. I think there should be links for alternative setups - like how to run the T5 app from a main class and even start VisualVM for early debugging and optimizing (each alternative has pros and cons). There is no mention of m2eclipse plugin. Of course one can use JDK 6 also - only 1.5 is there. There is a sentence: "You should not have to download this directly". Why are then download links on the download page and no mention of maven at the same time. It is confusing for newbs.</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; te
xt-align: right;">
+ Medium
+ </td></tr><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input disabled></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%">Add a link to JIRA in the About page</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; text-align: right;">
+ Medium
+ </td></tr><tr><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 10%;"><input disabled></td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 70%">Resolve the TODO at the bottom of <a shape="rect" href="component-classes.html" title="Component Classes">Component Classes</a> ("May want a more complex check; what if user uses prop: in the template and there's a conflict?")</td><td colspan="1" rowspan="1" style="border-top: 1px solid #cbcbcb; width: 20%; text-align: right;">
+ Medium
+ </td></tr></tbody></table>
</div></div>
</div>
Modified: websites/production/tapestry/content/dom.html
==============================================================================
--- websites/production/tapestry/content/dom.html (original)
+++ websites/production/tapestry/content/dom.html Sun Jul 19 21:21:27 2015
@@ -27,6 +27,16 @@
</title>
<link type="text/css" rel="stylesheet" href="/resources/space.css">
+ <link href='/resources/highlighter/styles/shCoreCXF.css' rel='stylesheet' type='text/css' />
+ <link href='/resources/highlighter/styles/shThemeCXF.css' rel='stylesheet' type='text/css' />
+ <script src='/resources/highlighter/scripts/shCore.js' type='text/javascript'></script>
+ <script src='/resources/highlighter/scripts/shBrushJava.js' type='text/javascript'></script>
+ <script src='/resources/highlighter/scripts/shBrushXml.js' type='text/javascript'></script>
+ <script src='/resources/highlighter/scripts/shBrushPlain.js' type='text/javascript'></script>
+ <script type="text/javascript">
+ SyntaxHighlighter.defaults['toolbar'] = false;
+ SyntaxHighlighter.all();
+ </script>
<link href="/styles/style.css" rel="stylesheet" type="text/css"/>
@@ -60,25 +70,25 @@
<div id="ConfluenceContent"><h1 id="DOM-DocumentObjectModel">Document Object Model</h1><p>Tapestry 5 takes a very different approach to markup generation than most other frameworks. Components render out a Document Object Model (DOM). This is a tree of nodes representing elements, attributes and text within a document.</p><p>Once all rendering is complete, the DOM tree is streamed to the client.</p><p>The <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/MarkupWriter.html">MarkupWriter</a> interface allows the majority of component code to treat the generation of output as a stream. In reality, MarkupWriter is more like a cursor into the DOM tree, and the DOM may ultimately be operated upon in a random access manner (rather than the serial (or buffered) approach used in Tapestry 4).</p><div class="navmenu" style="float:right; width:30%; background:white; margin:3px; padding:3px">
<div class="confluence-information-macro confluence-information-macro-information"><p class="title">A Note For Tapestry 4 Users</p><span class="aui-icon aui-icon-small aui-iconfont-info confluence-information-macro-icon"></span><div class="confluence-information-macro-body">
<p>In Tapestry 4, markup generation was based on generating a character stream. At the lowest level, the fact that the output was in a markup format such as HTML, XHTML or WML was not known. Higher levels, such as the IMarkupWriter interface (and its implementations) provide the concept of markup generation: elements, attributes, start tags and end tags. This technique breaks down when two elements are peers, and not in a parent/child relationship. For example, the rendering of a FieldLabel component is affected by its companion TextField component. Handling these cases in Tapestry 4 required a number of kludges and special cases.</p></div></div></div><h1 id="DOM-DOMClasses">DOM Classes</h1><p>The implementation of this DOM is part of Tapestry, despite the fact that several third-party alternatives exist. This represents a desire to limit dependencies for the framework, but also the Tapestry DOM is streamlined for initial creation, and a limited amount of subsequent modification. Mo
st DOM implementations are more sophisticated than needed for Tapestry, with greater support for querying (often using XPath) and manipulation.</p><p>Once the Document object is created, you don't directly create new DOM objects; instead, each DOM object includes methods that create new sub-objects. This primarily applies to the Element class, which can be a container of text, comments and other elements.</p><h2 id="DOM-Document">Document</h2><p>The <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/dom/Document.html">Document Object</a> represents the an entire document, which is to say, an entire response to be sent to the client.</p><p>Documents will have a single root element. The newRootElement() method is used to create the root element for the document.</p><p>The Document class also has methods for setting and getting the DTD, adding comments and text, and finding an element based on a path of element names.</p><h2 id="
DOM-Element">Element</h2><p>An <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/dom/Element.html">Element Object</a> represents an element of the document. Elements may have attributes, and they may themselves contain other elements, as well as text and comments.</p><p>The Element class has methods for searching, traversing and manipulating the DOM after it is built.</p><h1 id="DOM-DOMManipulation/Rewriting">DOM Manipulation/Rewriting</h1><p>A powerful feature of Tapestry 5 is the ability to manipulate the structure and ordering of the DOM after it has been rendered. For example, this can be used to alter the output of a component that may otherwise be outside of your control.</p><p>DOM manipulation is surprisingly fast, too.</p><p>Methods on Node (and Element, which is a subclass of Node) allow an existing node to be moved relative to an Element. Nodes may be moved before or after the Element, or may be moved inside an Elem
ent at the top (the first child) or the bottom (the last child).</p><p>Element's <code>attribute</code> method adds a new attribute name/value pair to the Element. If an existing attribute with the specified name already exists, then then the new value is ignored. This has implications when different pieces of code try to add attributes to an Element ... the first to add an attribute will "win". Conversely, the <code>forceAttributes</code> method can be used to update or remove an attribute.</p><p>In addition, the children of an Element may be removed or a Node (and all of its children) removed entirely.</p><p>Finally, an Element may "pop": the Element is removed and replaced with its children.</p><h1 id="DOM-MarkupWriter">MarkupWriter</h1><p>The <a shape="rect" class="external-link" href="http://tapestry.apache.org/current/apidocs/org/apache/tapestry5/MarkupWriter.html">MarkupWriter interface</a> allows the structure of the document to be built while maintaining a streaming metapho
r.</p><h2 id="DOM-element()andend()methods">element() and end() methods</h2><p>Calls to element() create a new element within the tree, and may provide attributes for the new element as well. Calls to write(), writeln() and writef() write text nodes within the current element. <em>Every call to element() should be matched with a call to end()</em>, which is used to move the current node up one level.</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[ writer.element("img", "src", "icon.png", "width", 20, "height", 20, alt, "*");
+<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;"> writer.element("img", "src", "icon.png", "width", 20, "height", 20, alt, "*");
writer.end();
-]]></script>
+</pre>
</div></div><p>Note that end() must be called here, even though the <img> element is empty (has no body). If the call to end() is omitted, then later elements created by calls to element() will be nested <em>inside</em> the <img> element, which is not desired.</p><p>Again, <strong>every call to element() must be matched with a call to end()</strong>:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[ writer.element("select", "name", "choice");
+<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;"> writer.element("select", "name", "choice");
for (String name : optionsNames)
{
- writer.element("option");
+ writer.element("option");
writer.write(name);
writer.end();
}
writer.end();
-]]></script>
+</pre>
</div></div><h2 id="DOM-attributes()">attributes()</h2><p>Adds additional name/value pairs to the current element.</p><p>When a value is null, no attribute is added.</p><p>When a new name conflicts with an existing name, the new value is ignored. This gives precedence to the first value specified for an attribute over any subsequent value.</p><h2 id="DOM-write()">write()</h2><p>The write() method writes text inside the current element. It scans the provided text for XML control characters ('<', '>', and '&') and converts them to their XML entity equivalents ('<', '>', and '&'). The result is correct, safe, HTML/XML output even when the content (which may come from a template, or from an external source such as a database) contains such problematic characters.</p><h2 id="DOM-writef()">writef()</h2><p>The writef() method formats an number of arguments. It uses a java.util.Formatter. It is a convenience for formatting that ultimately invokes write().</p><h2 id="DOM-
writeRaw()">writeRaw()</h2><p>The writeRaw() method writes unfiltered text into the DOM. When the DOM is rendered to markup, the provided string is written to the output stream exactly as-is. Care should be taken, as this can easily result invalid markup, or even markup that is not well formed.</p><h2 id="DOM-comment()">comment()</h2><p>Adds an XML comment. The comment delimiters will be supplied by Tapestry:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[ writer.comment("Start of JS Menu code");
+<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;"> writer.comment("Start of JS Menu code");
-]]></script>
+</pre>
</div></div></div>
</div>
Modified: websites/production/tapestry/content/download.html
==============================================================================
--- websites/production/tapestry/content/download.html (original)
+++ websites/production/tapestry/content/download.html Sun Jul 19 21:21:27 2015
@@ -27,6 +27,15 @@
</title>
<link type="text/css" rel="stylesheet" href="/resources/space.css">
+ <link href='/resources/highlighter/styles/shCoreCXF.css' rel='stylesheet' type='text/css' />
+ <link href='/resources/highlighter/styles/shThemeCXF.css' rel='stylesheet' type='text/css' />
+ <script src='/resources/highlighter/scripts/shCore.js' type='text/javascript'></script>
+ <script src='/resources/highlighter/scripts/shBrushJava.js' type='text/javascript'></script>
+ <script src='/resources/highlighter/scripts/shBrushXml.js' type='text/javascript'></script>
+ <script type="text/javascript">
+ SyntaxHighlighter.defaults['toolbar'] = false;
+ SyntaxHighlighter.all();
+ </script>
<link href="/styles/style.css" rel="stylesheet" type="text/css"/>
@@ -58,22 +67,22 @@
<div id="content">
<div id="ConfluenceContent"><p>Tapestry can be downloaded in either binary or source format.</p><div class="confluence-information-macro confluence-information-macro-information"><span class="aui-icon aui-icon-small aui-iconfont-info confluence-information-macro-icon"></span><div class="confluence-information-macro-body"><p>The easiest way to download Tapestry and its dependencies is using Maven, as described in <a shape="rect" href="getting-started.html">Getting Started</a>.</p></div></div><p>See the <a shape="rect" href="release-notes.html">Release Notes</a> for differences between versions and how to upgrade.</p><h1 id="Download-StableReleases">Stable Releases</h1><p>Stable releases should be relatively free of critical bugs and are considered the <em>safest</em> option if stability is a requirement.</p><h2 id="Download-Tapestry5.3.x">Tapestry 5.3.x</h2><p>Tapestry 5.3.8 was released on 20 Nov 2014. See the <a shape="rect" href="release-notes-538.html">release notes</a> for more
details.</p><p>Note that the <em>recommended</em> distribution method of binary and source JARs is via Maven repository. Binaries, source code, and Javadocs are also available as a zip archive.</p><div class="sectionColumnWrapper"><div class="sectionMacro"><div class="sectionMacroRow"><div class="columnMacro"><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Tapestry 5.3.8</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Mirrors</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Signature</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>MD5</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Binary (zip)</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dyn/closer.cgi/tapestry/apache-tapestry-5.3.8-bin.zip">Download</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect"
class="external-link" href="http://www.apache.org/dist/tapestry/apache-tapestry-5.3.8-bin.zip.asc">ASC</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>0509cda0f16f96a0ddca9351ec80a59d</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Source (zip)</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dyn/closer.cgi/tapestry/apache-tapestry-5.3.8-sources.zip">Download</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dist/tapestry/apache-tapestry-5.3.8-sources.zip.asc">ASC</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>6de96428545fd235389c51d8e1d9008a</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Javadoc (zip)</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dyn/closer.cgi/tapestry/apa
che-tapestry-5.3.8-javadocs.zip">Download</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dist/tapestry/apache-tapestry-5.3.8-javadocs.zip.asc">ASC</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>f1ba1d4fa6fcbd10467aa5b803a5a001</p></td></tr></tbody></table></div></div><div class="columnMacro"><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>Maven Dependency</b></div><div class="codeContent panelContent pdl">
-<script class="brush: xml; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[<dependency>
+<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"><dependency>
<groupId>org.apache.tapestry</groupId>
<artifactId>tapestry-core</artifactId>
<version>5.3.8</version>
</dependency>
-]]></script>
+</pre>
</div></div></div></div></div></div><p><span style="line-height: 1.5;color: rgb(83,145,38);font-size: 20.0px;"><br clear="none"></span></p><p><span style="line-height: 1.5;color: rgb(83,145,38);font-size: 20.0px;">Archives</span></p><p>Looking for an older version of Tapestry? Try the <a shape="rect" class="external-link" href="http://archive.apache.org/dist/tapestry/">archives</a>.</p><h1 id="Download-ReleasesUnderDevelopment">Releases Under Development</h1><p>Releases under development are less stable; <em>alpha</em> releases are often incomplete; <em>beta</em> releases occur in the lead up to creation of a stable release.</p><p>Tapestry 5.4 is under <a shape="rect" class="external-link" href="https://git1-us-west.apache.org/repos/asf?p=tapestry-5.git;a=shortlog">active development</a>. There have been a series beta releases so far, and several have been voted for general release. The most recent is <strong>5.4-beta-26</strong>.</p><p> </p><div class="sectionColumnWrapper"><d
iv class="sectionMacro"><div class="sectionMacroRow"><div class="columnMacro"><div class="table-wrap"><table class="confluenceTable"><tbody><tr><th colspan="1" rowspan="1" class="confluenceTh"><p>Tapestry 5.4-beta-26</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Mirrors</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>Signature</p></th><th colspan="1" rowspan="1" class="confluenceTh"><p>MD5</p></th></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Binary (zip)</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dyn/closer.cgi/tapestry/apache-tapestry-5.4-beta-26-bin.zip">Download</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dist/tapestry/apache-tapestry-5.4-beta-26-bin.zip.asc">ASC</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>9f3765a4712818389765a69e561fb25e</p></td></tr><
tr><td colspan="1" rowspan="1" class="confluenceTd"><p>Source (zip)</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dyn/closer.cgi/tapestry/apache-tapestry-5.4-beta-26-sources.zip">Download</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dist/tapestry/apache-tapestry-5.4-beta-26-sources.zip.asc">ASC</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>52956107049086841b02ecdb18e93b60</p></td></tr><tr><td colspan="1" rowspan="1" class="confluenceTd"><p>API Docs (zip)</p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dyn/closer.cgi/tapestry/apache-tapestry-5.4-beta-26-apidocs.zip">Download</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p><a shape="rect" class="external-link" href="http://www.apache.org/dist/tapestry/apache-tape
stry-5.4-beta-26-apidocs.zip.asc">ASC</a></p></td><td colspan="1" rowspan="1" class="confluenceTd"><p>f730230c5850480b211780c0dce702fa</p></td></tr></tbody></table></div></div><div class="columnMacro"><div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>Maven Dependency</b></div><div class="codeContent panelContent pdl">
-<script class="brush: xml; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[<dependency>
+<pre class="brush: xml; gutter: false; theme: Default" style="font-size:12px;"><dependency>
<groupId>org.apache.tapestry</groupId>
<artifactId>tapestry-core</artifactId>
<version>5.4-beta-26</version>
</dependency>
-]]></script>
+</pre>
</div></div></div></div></div></div><p>Nightly snapshot binaries are also available in Apache's Nexus <a shape="rect" class="external-link" href="https://repository.apache.org">Maven repository</a> under the subdirectories of <a shape="rect" class="external-link" href="https://repository.apache.org/content/repositories/snapshots/org/apache/tapestry">https://repository.apache.org/content/repositories/snapshots/org/apache/tapestry</a>. Please be aware that nightly snapshots have not been reviewed and may have significant stability problems from time to time.</p><h1 id="Download-Downloadsources">Download sources</h1><p>The source download links are listed in the boxes above. In addition, the source code can be checked out anonymously from Git with the <a shape="rect" class="external-link" href="http://gitref.org/creating/#clone" >clone</a> command:</p><div class="code panel pdl" style="border-width: 1px;"><div class="codeContent panelContent pdl">
-<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[git clone http://git-wip-us.apache.org/repos/asf/tapestry-5.git
-]]></script>
+<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">git clone http://git-wip-us.apache.org/repos/asf/tapestry-5.git
+</pre>
</div></div><p>(See <a shape="rect" href="building-tapestry-from-source.html">Building Tapestry from Source</a> for more info.)</p><p>Versions 5.3.2 and earlier are also available via Subversion, at <a shape="rect" class="external-link" href="https://svn.apache.org/repos/asf/tapestry/tapestry5/trunk/">https://svn.apache.org/repos/asf/tapestry/tapestry5/trunk/</a></p><h2 id="Download-Accessfrombehindafirewall">Access from behind a firewall</h2><p>Refer to the documentation of your Git client for more information about access behind a firewall. Generally this requires configuring access through a proxy (by specifying the proxy host and port) or opening up a port on the firewall.</p></div>
</div>
Modified: websites/production/tapestry/content/enum-parameter-recipe.html
==============================================================================
--- websites/production/tapestry/content/enum-parameter-recipe.html (original)
+++ websites/production/tapestry/content/enum-parameter-recipe.html Sun Jul 19 21:21:27 2015
@@ -27,6 +27,16 @@
</title>
<link type="text/css" rel="stylesheet" href="/resources/space.css">
+ <link href='/resources/highlighter/styles/shCoreCXF.css' rel='stylesheet' type='text/css' />
+ <link href='/resources/highlighter/styles/shThemeCXF.css' rel='stylesheet' type='text/css' />
+ <script src='/resources/highlighter/scripts/shCore.js' type='text/javascript'></script>
+ <script src='/resources/highlighter/scripts/shBrushJava.js' type='text/javascript'></script>
+ <script src='/resources/highlighter/scripts/shBrushXml.js' type='text/javascript'></script>
+ <script src='/resources/highlighter/scripts/shBrushPlain.js' type='text/javascript'></script>
+ <script type="text/javascript">
+ SyntaxHighlighter.defaults['toolbar'] = false;
+ SyntaxHighlighter.all();
+ </script>
<link href="/styles/style.css" rel="stylesheet" type="text/css"/>
@@ -57,15 +67,7 @@
</div>
<div id="content">
-<div id="ConfluenceContent"><style type="text/css">/*<![CDATA[*/
-table.ScrollbarTable {border: none;padding: 3px;width: 100%;padding: 3px;margin: 0px;background-color: #f0f0f0}
-table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
-table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
-table.ScrollbarTable td.ScrollbarParent {text-align: center;border: none;}
-table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
-table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}
-
-/*]]>*/</style><div class="Scrollbar"><table class="ScrollbarTable"><tr><td colspan="1" rowspan="1" class="ScrollbarPrevIcon"><a shape="rect" href="switching-cases.html"><img align="middle" border="0" src="https://cwiki.apache.org/confluence/images/icons/back_16.gif" width="16" height="16"></a></td><td colspan="1" rowspan="1" class="ScrollbarPrevName" width="33%"><a shape="rect" href="switching-cases.html">Switching Cases</a> </td><td colspan="1" rowspan="1" class="ScrollbarParent" width="33%"><sup><a shape="rect" href="cookbook.html"><img align="middle" border="0" src="https://cwiki.apache.org/confluence/images/icons/up_16.gif" width="8" height="8"></a></sup><a shape="rect" href="cookbook.html">Cookbook</a></td><td colspan="1" rowspan="1" class="ScrollbarNextName" width="33%"> <a shape="rect" href="extending-the-if-component.html">Extending the If Component</a></td><td colspan="1" rowspan="1" class="ScrollbarNextIcon"><a shape="rect" href="extending-the-if-component.html"
><img align="middle" border="0" src="https://cwiki.apache.org/confluence/images/icons/forwd_16.gif" width="16" height="16"></a></td></tr></table></div>
+<div id="ConfluenceContent">
<p></p>
<h1 id="EnumParameterRecipe-EnumComponentParameter">Enum Component Parameter</h1>
@@ -77,7 +79,7 @@ table.ScrollbarTable td.ScrollbarNextIco
<p>Let's start with the enum type itself:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>BlankOption.java</b></div><div class="codeContent panelContent pdl">
-<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[
+<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">
public enum BlankOption
{
/**
@@ -95,22 +97,22 @@ public enum BlankOption
*/
AUTO;
}
-]]></script>
+</pre>
</div></div>
<p>Next, we define the parameter:</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>Select.java (partial)</b></div><div class="codeContent panelContent pdl">
-<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[
+<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">
/**
* Controls whether an additional blank option is provided. The blank option precedes all other options and is never
* selected. The value for the blank option is always the empty string, the label may be the blank string; the
* label is from the blankLabel parameter (and is often also the empty string).
*/
- @Parameter(value = "auto", defaultPrefix = BindingConstants.LITERAL)
+ @Parameter(value = "auto", defaultPrefix = BindingConstants.LITERAL)
private BlankOption blankOption;
-]]></script>
+</pre>
</div></div>
<p>Note the use of literal as the default prefix; this allows us to use the name of the option in our template, e.g. <code><t:select blankoption="never" .../></code>. Without the default prefix setting, "never" would be interpreted as a property expression (and you'd see an error when you loaded the page).</p>
@@ -118,7 +120,7 @@ public enum BlankOption
<p>The final piece of the puzzle is to inform Tapestry how to convert from a string, such as "never", to a BlankOption value.</p>
<div class="code panel pdl" style="border-width: 1px;"><div class="codeHeader panelHeader pdl" style="border-bottom-width: 1px;"><b>TapestryModule.java (partial)</b></div><div class="codeContent panelContent pdl">
-<script class="brush: java; gutter: false; theme: Default" type="syntaxhighlighter"><![CDATA[
+<pre class="brush: java; gutter: false; theme: Default" style="font-size:12px;">
public static void contributeTypeCoercer(Configuration<CoercionTuple> configuration)
{
. . .
@@ -132,7 +134,7 @@ public enum BlankOption
{
configuration.add(CoercionTuple.create(String.class, enumType, StringToEnumCoercion.create(enumType)));
}
-]]></script>
+</pre>
</div></div>
<p>The TypeCoercer service is ultimately responsible for converting the string to a BlankOption, but we have to tell it how, by contributing an appropriate CoercionTuple. The CoercionTuple identifies the source and target types (String and BlankOption), and an object to perform the coercion (an instance of StringToEnumCoercion, via the <code>create()</code> static method).</p></div>