[aspectwerkz-dev] [jira] Deleted: (AW-34) Clean up Documentation and Examples

"[email protected] (JIRA)" <jira-yCVjj/[email protected]> Fri, 3 Aug 2007 07:09:56 +1000 (EST)
Newsgroups gmane.comp.java.aspectwerkz.devel
Message-ID <[email protected]>
     [ http://jira.codehaus.org/browse/AW-34?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

[email protected] deleted AW-34:
--------------------------------


> Clean up Documentation and Examples
> -----------------------------------
>
>                 Key: AW-34
>                 URL: http://jira.codehaus.org/browse/AW-34
>             Project: AspectWerkz
>          Issue Type: Improvement
>         Environment: All
>            Reporter: Chad Woolley
>            Priority: Minor
>   Original Estimate: 0 minutes
>  Remaining Estimate: 0 minutes
>
> First of all, great job on this tool.
> I realize you have just redesigned the definition language and probably are already working on this, but I think the following tasks are important for new people trying to use AspectWerkz.
> When trying to learn AspectWerkz 0.6.3, the documentation and examples are very confusing.  Examples:
> - The "Logging" example uses inline Javadoc tags to perform the weaving.  However, there are still many misleading references to "Logging" aspects in the various XML files, and the online example docs.  This caused me a ton of confusion, because until I noticed the tags, the aspect seemed to be working by magic (without any XML defs)
> - There are several confusing, redundant, and outdated examples of syntax in the distribution XML files.  For example, definitiontest.xml vs newdef.xml.
> Thanks and good luck....

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

---------------------------------------------------------------------
To unsubscribe from this list please visit:

    http://xircles.codehaus.org/manage_email