You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 24 Next »

This is an informal list of the shortcomings in the Tapestry 5 site documentation – things to work on soon.

0%

Task List

  1. handler

    Need more cross-linking between the wiki pages, specially between FAQ pages, User Guide pages, Cheat Sheet pages and Cookbook pages that cover the same topic.

    Priority HIGH
    N/A
  2. handler

    Component Cheat Sheet should have, for each of the listed annotations, a link to the corresponding API page.

    Priority MEDIUM
    N/A
  3. handler

    Some pages don't link to all of their child pages

    Priority MEDIUM
    N/A
  4. handler

    Move some of the best MoinMoin wiki content into Confluence?

    Priority MEDIUM
    N/A
  5. handler

    Need an article on clustering & high availability, then link to it from the clustering sections of Persistent Page Data, IoC - serialization, Persistent State, [Securing your application with HTTPS], and other pages that mention clustering

    Priority MEDIUM
    Nov 27, 2010
  6. handler

    Need a "Support" page that lists support options. This is where the mailing lists should be mentioned., as well as Howard's trainig, etc

    Priority MEDIUM
    Nov 27, 2010
  7. handler

    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

    Priority MEDIUM
    Nov 27, 2010
  8. handler

    Make it more obvious how to contribute to documentation improvements

    Priority MEDIUM
    Nov 27, 2010
  9. handler

    Add to Community Contributions page a link to http://lombok.demon.co.uk/tapestry5Demo/

    Priority MEDIUM
    bobharner
    Nov 27, 2010
  10. handler

    it doesn't look good to have a "Tapestry 5.2.3 – canceled" post on the front page. It's scary and you have to read the rest to know that it's just a release that didn't pass the vote. I know there's now a post above that saying 5.2.4 beta release, I'm commenting about the concept of "fear-about-the-future-of-tapestry" content with such visibility. Do we want things like that to see what potential new users get on their first visit?

    Priority MEDIUM
    bobharner
    Nov 27, 2010
  11. handler

    news feed titles have too large a font (already fixed?)

    Priority MEDIUM
    bobharner
    Nov 27, 2010
  12. handler

    there's too much text in the left column, looks intimidating.

    Priority MEDIUM
    bobharner
    Nov 27, 2010
  13. handler

    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.

    Priority MEDIUM
    bobharner
    Nov 27, 2010
  14. handler

    the big red scary warning about the project layout changing across different versions has no reason to be. By the time the user has this problem he will know how to solve it.

    Priority MEDIUM
    bobharner
    Nov 27, 2010
  15. handler

    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.

    Priority MEDIUM
    bobharner
    Nov 27, 2010
  16. handler

    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.

    Priority MEDIUM
    bobharner
    Nov 27, 2010
  • No labels