tapestry-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Christophe Cordenier <christophe.corden...@gmail.com>
Subject Re: [CONF] Apache Tapestry > Documentation
Date Wed, 08 Dec 2010 14:28:28 GMT
Right ! I suggest to put

- svn source URLs / JIRA into about
- How to get involved in Community page
- Mailing list / Stack overflow in documentation (Getting help)

Tell me what do you think of this ?

2010/12/8 Ulrich Stärk <uli@spielviel.de>

> Oh. Must have missed that.
>
> I think we need more though. Some of the information falls into a "getting
> help" categorie, some of it I'd rather put on the about page, e.g.
> information on how to obtain the source code or how to become involved; some
> of it is about third-party modules.
>
> Uli
>
>
> On 08.12.2010 14:55, Christophe Cordenier wrote:
>
>> 2010/12/8 Ulrich Stärk<uli@spielviel.de>
>>
>>  -1
>>>
>>> You are correct about the entry page being lightweight but you should not
>>> simply delete the information. Please make sure that the information you
>>> removed is accessible in other places and can be easily found.
>>>
>>>
>> Of course, this has been moved into the "Community" page. I think this
>> page
>> is more suitable for these kind of informations.
>>
>>
>>
>>> Uli
>>>
>>> On 08.12.2010 13:47, confluence@apache.org wrote:
>>>
>>>
>>>>    Documentation<
>>>> https://cwiki.apache.org/confluence/display/TAPESTRY/Documentation>
>>>>
>>>>
>>>>        Page *edited* by Christophe Cordenier<
>>>> https://cwiki.apache.org/confluence/display/~ccordenier<https://cwiki.apache.org/confluence/display/%7Eccordenier>
>>>> <https://cwiki.apache.org/confluence/display/%7Eccordenier>
>>>>
>>>>
>>>>>
>>>> *Comment:* Leverage the page, as a root page it must be kept light
>>>>
>>>>
>>>>
>>>>        Changes (1)
>>>>
>>>> ...
>>>> [More blogs|TAPESTRY:Blogs] ...
>>>>
>>>> h1. Getting Involved
>>>>
>>>> h2. Mailing Lists
>>>>
>>>> The primary method of discussion is on the Tapestry users mailing list:
>>>> [mailto:users@tapestry.apache.org]. You can subscribe by sending e-mail
>>>> to
>>>> [mailto:users-subscribe@tapestry.apache.org]. This is the appropriate
>>>> mailing list to learn more
>>>> about Tapestry, to request help, and to socialize.
>>>>
>>>> The second mailing list is [mailto:dev@tapestry.apache.org]. You can
>>>> subscribe to this list by
>>>> sending e-mail to [dev-subscribe@tapestry.apache.org|mailto:
>>>> dev-subscribe@tapestry.apache.org].
>>>> This list is used by the Tapestry PMC and committers to run votes,
>>>> discuss
>>>> issues and fixes, and
>>>> plan the future of Tapestry. Please don't use this mailing list to ask
>>>> for
>>>> support.
>>>>
>>>> Mailing list archives are available at [http://tapestry.markmail.org/].
>>>>
>>>> h2. Reporting Problems / Getting Support
>>>>
>>>> Tapestry issues are tracked in the [Apache JIRA|
>>>> https://issues.apache.org/jira/browse/TAP5].
>>>>
>>>> Unless your problem is clear as day, it's a good idea to discuss it on
>>>> the
>>>> Tapestry Users mailing
>>>> list first, before adding an issue. At the same time, it's generally
>>>> unlikely that a bug will be
>>>> fixed _unless_ a JIRA Issue is created.
>>>>
>>>> Eric Raymond has a detailed [guide to asking questions the right
>>>> way|http://catb.org/esr/faqs/smart-questions.html]. If you are not
>>>> getting a response to your
>>>> problem, it's likely because you aren't asking it the right way.
>>>>
>>>> Just saying something is "broken" or "failed" is not enough. How did it
>>>> fail? Did it do the wrong
>>>> thing? Throw an exception? Not respond in any way? What exactly did you
>>>> expect to happen? All of
>>>> this information should be made available when looking for help, plus
>>>> context on the general problem
>>>> you were trying to solve in the first place (there may be a better
>>>> solution entirely). Read Eric
>>>> Raymond's guide ... it's fun and informative.
>>>>
>>>> h2. Source Code Access
>>>>
>>>> Source code for Tapestry can be [downloaded|TAPESTRY:Download] along
>>>> with
>>>> pre-compiled binaries.
>>>>
>>>> Tapestry uses [Subversion|http://subversion.apache.org/] to manage the
>>>> project's source code.
>>>>
>>>> Web access to the Tapestry repository is available as
>>>> [http://svn.apache.org/viewvc/tapestry/tapestry5/trunk].
>>>>
>>>> Access using Subversion client:
>>>>
>>>> {noformat}
>>>> $ svn checkout
>>>> https://svn.apache.org/repos/asf/tapestry/tapestry5/trunktapestry-project
>>>>
>>>> {noformat}
>>>>
>>>> There's also some [notes on using Git to access
>>>> Tapestry|
>>>>
>>>> http://tapestryjava.blogspot.com/2010/04/setting-up-committer-access-git-for.html
>>>> ].
>>>>
>>>> h2. Other Resources
>>>>
>>>> There is an active flow of questions and answers about Tapestry at
>>>> [Stack
>>>> Overflow|http://stackoverflow.com/questions/tagged/tapestry].
>>>>
>>>> h2. Becoming a Contributor
>>>>
>>>> The best way to become a contributor is to become active on the mailing
>>>> list; Tapestry is known to
>>>> have an active and helpful community on the mailing list, and the more
>>>> mentors we can add, the better.
>>>>
>>>> If you want to help out with documentation, you must sign an [Apache
>>>> Contributor License
>>>> Agreement|http://www.apache.org/licenses/#clas], at which point we can
>>>> grant write access to the
>>>> Confluence Wiki (where official documentation is created).
>>>>
>>>> Providing patches (with tests\!) is another way to become a contributor.
>>>>
>>>> h2. Becoming a Committer
>>>>
>>>> Active contributors may be asked to become full committers, with write
>>>> access to the source code.
>>>> Generally, contributors who have been consistently active and helpful
>>>> for
>>>> three to six months are
>>>> eligible for committer access. If you think you are in that category,
>>>> don't be shy about contacting
>>>> members of the Tapestry PMC (Project Management Committee).
>>>>
>>>> h1. Books on Tapestry
>>>>
>>>> ...
>>>>
>>>>
>>>>        Full Content
>>>>
>>>> Welcome to Tapestry 5 Documentation root page.
>>>>
>>>>    * Overview<#Documentation-Overview>
>>>>    * Tapestry 5 Reference and API
>>>> <#Documentation-Tapestry5ReferenceandAPI>
>>>>    * User Guides<#Documentation-UserGuides>
>>>>    * Published Articles on Tapestry
>>>> <#Documentation-PublishedArticlesonTapestry>
>>>>    * Tapestry Developer and Community Blogs
>>>> <#Documentation-TapestryDeveloperandCommunityBlogs>
>>>>    * Books on Tapestry<#Documentation-BooksonTapestry>
>>>>    * Tapestry Presentations<#Documentation-TapestryPresentations>
>>>>    * Tapestry Wikis<#Documentation-TapestryWikis>
>>>>    * The Developer Corner<#Documentation-TheDeveloperCorner>
>>>>
>>>>
>>>>  Overview
>>>>
>>>> Introduction</confluence/display/TAPESTRY/Introduction>         An
>>>> overview of Tapestry's general approach
>>>> and philosophy
>>>> Getting Started</confluence/display/TAPESTRY/Getting+Started>
>>>>
>>>>        A quick guide to creating your first Tapestry project, using
>>>> Maven
>>>> Tapestry Tutorial</confluence/display/TAPESTRY/Tapestry+Tutorial>
>>>>        Picks up where Getting Started
>>>> </confluence/display/TAPESTRY/Getting+Started>  leaves off,
>>>>
>>>> explaining in greater detail how Tapestry works
>>>> Cookbook</confluence/display/TAPESTRY/Cookbook>
>>>>
>>>>        A guide to common overrides and extensions to Tapestry
>>>> FAQ</confluence/display/TAPESTRY/Frequently+Asked+Questions>
>>>>
>>>>        A quick place to check for common problems and solutions
>>>>
>>>>
>>>>  Tapestry 5 Reference and API
>>>>
>>>>    * Current stable release 5.1.0.5
>>>>          o API (Javadoc)<
>>>> http://tapestry.apache.org/tapestry5.1/apidocs/
>>>>
>>>>>
>>>>>           o Component Reference<
>>>> http://tapestry.apache.org/tapestry5.1/tapestry-core/ref/>
>>>>          o Release Notes<
>>>> http://tapestry.apache.org/tapestry5.1/release-notes.html>
>>>>
>>>>    * Previous stable release 5.0.18
>>>>          o API (Javadoc)<http://tapestry.apache.org/tapestry5/apidocs/>
>>>>          o Component Reference<
>>>> http://tapestry.apache.org/tapestry5/tapestry-core/ref/>
>>>>          o Release Notes<
>>>> http://tapestry.apache.org/tapestry5/release-notes-5.0.html>
>>>>
>>>>    * Current beta release 5.2.4
>>>>          o API (Javadoc)<
>>>> http://tapestry.apache.org/tapestry5.2-dev/apidocs/>
>>>>          o Component Reference<
>>>> http://tapestry.apache.org/tapestry5.2-dev/tapestry-core/ref/>
>>>>          o Release Notes
>>>> </confluence/display/TAPESTRY/Release+Notes+5.2.4>
>>>>
>>>>
>>>> Along with the reference documentation, we provide a set of concise
>>>> guides
>>>> to help you in your
>>>> everyday work with Tapestry.
>>>>
>>>>    * Component Cheat Sheet
>>>> </confluence/display/TAPESTRY/Component+Cheat+Sheet>  is a concise
guide
>>>>
>>>>      to component classes, methods and annotations
>>>>    * Refcard<
>>>> http://refcardz.dzone.com/refcardz/apache-tapestry-50?oid=hom7948>  A
>>>> color, six page
>>>>
>>>>      foldout guide to Tapestry 5.0 (PDF)
>>>>
>>>>
>>>>  User Guides
>>>>
>>>> We provide a collection of detailed references
>>>> </confluence/display/TAPESTRY/User+Guide>  to the
>>>>
>>>> concepts behind Tapestry and beyond.
>>>>
>>>>    * Go to the main user guide's page
>>>> </confluence/display/TAPESTRY/User+Guide>  to get access to
>>>>
>>>>      the whole documentation stack
>>>>    * Play with Tapestry's built-in Javascript and Ajax
>>>>      </confluence/pages/viewpage.action?pageId=21792074>  stuff
>>>>    * Unit test your application with Tapestry test utilities
>>>> </confluence/display/TAPESTRY/Test>
>>>>    * Integrate Spring</confluence/display/TAPESTRY/Spring>  into your
>>>> Tapestry application
>>>>    * Use Tapestry Hibernate integration
>>>> </confluence/display/TAPESTRY/Hibernate+-+Core+-+Conf>  to
>>>>
>>>>      build your data access layer
>>>>
>>>>
>>>>  Published Articles on Tapestry
>>>>
>>>> If you have any doubts, Tapestry 5 for Nonbelievers<
>>>> http://www.infoq.com/articles/tapestry5-intro>
>>>>
>>>> will demonstrate why you should choose Tapestry 5!
>>>> This eBook<
>>>> http://www.laliluna.de/articles/the-web-framework-evaluation.html>
>>>> publish in 2009
>>>>
>>>> contains a good introduction and analysis of Tapestry 5
>>>> <
>>>>
>>>> http://www.laliluna.de/articles/2009/08/14/tapestry-web-framework-evaluation-and-test.html
>>>>
>>>>>
>>>>>
>>>> More articles</confluence/display/TAPESTRY/Articles>...
>>>>
>>>>
>>>>
>>>>  Tapestry Developer and Community Blogs
>>>>
>>>>    * Tapestry Central<http://tapestryjava.blogspot.com/>  is Howard
>>>> Lewis
>>>> Ship's blog. As the
>>>>
>>>>      creator of Tapestry, he provides a lot of valuable information on
>>>> Tapestry's latest features
>>>>      and future directions.
>>>>    * Igor Drobiazko's blog<http://blog.tapestry5.de/>  contains a lot
>>>> of
>>>> fresh news on Tapestry
>>>>
>>>>      development and will guide you through the most exciting parts of
>>>> Tapestry. Igor is a Tapestry
>>>>      Committer and PMC member.
>>>>    * Andreas Andreou's blog<http://blog.andyhot.gr/tag/tapestry/>
>>>> (committer&  PMC) has lots of
>>>>
>>>>      news and entries on Tapestry 4 and 5.
>>>>    * Spread the source's blog<http://spreadthesource.com/>  (Christophe
>>>> Cordenier and Robin Komiwes
>>>>
>>>>      committers's blog) has lots of news and advanced tutorials on
>>>> Tapestry 5.
>>>>
>>>> More blogs</confluence/display/TAPESTRY/Blogs>  ...
>>>>
>>>>
>>>>  Books on Tapestry
>>>>
>>>> There are at least 8 published books on Tapestry
>>>> </confluence/display/TAPESTRY/Books>, including two
>>>>
>>>> on Tapestry 5 — and more on the way.
>>>>
>>>>
>>>>  Tapestry Presentations
>>>>
>>>>    * JavaServer Faces 2.0 vs. Tapestry 5
>>>>      <
>>>> http://jazoon.com/Portals/0/Content/slides/th_a7_1130-1220_drobiazko.pdf
>>>> >:
>>>> A Head-to-Head
>>>>
>>>>      Comparison by Igor Drobiazko at Jazoon 2010
>>>>    * Tapestry 5: Java power, Scripting Ease<
>>>> http://www.parleys.com/#st=5&sl=5&id=1700>  by Howard
>>>>
>>>>      Lewis Ship at Devoxx 2009
>>>>
>>>> More presentations</confluence/display/TAPESTRY/Presentations>  ...
>>>>
>>>>
>>>>  Tapestry Wikis
>>>>
>>>>    * Community's Wiki<http://wiki.apache.org/tapestry/FrontPage>  (Moin
>>>> Moin) contains a lot of
>>>>
>>>>      user-generated information on different concrete web application
>>>> use
>>>> cases.
>>>>    * Documentation Source wiki<
>>>> https://cwiki.apache.org/confluence/x/VCFkAQ>  (Confluence) – the
>>>>
>>>>      wiki used as the content editor for the official Tapestry
>>>> documentation
>>>>
>>>>
>>>>  The Developer Corner
>>>>
>>>> Developer
>>>> Information</confluence/display/TAPESTRY/Developer+Information>
>>>> gives information needed
>>>> by the Tapestry developers
>>>>
>>>> Change Notification Preferences<
>>>> https://cwiki.apache.org/confluence/users/viewnotifications.action>
>>>> View Online<
>>>> https://cwiki.apache.org/confluence/display/TAPESTRY/Documentation>  |
>>>> View Changes
>>>> <
>>>>
>>>> https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=20645554&revisedVersion=40&originalVersion=39
>>>>
>>>>>
>>>>>
>>>>
>>>>  ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: dev-unsubscribe@tapestry.apache.org
>>> For additional commands, e-mail: dev-help@tapestry.apache.org
>>>
>>>
>>>
>>
>>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@tapestry.apache.org
> For additional commands, e-mail: dev-help@tapestry.apache.org
>
>


-- 
Regards,
Christophe Cordenier.

Committer on Apache Tapestry 5
Co-creator of wooki @wookicentral.com

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message