[jbosstools-issues] [JBoss JIRA] Commented: (JBIDE-4779) Birt docs is unusable

[prakash aradhya (JIRA)]

    [ https://jira.jboss.org/jira/browse/JBIDE-4779?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12490083#action_12490083 ] 

prakash aradhya commented on JBIDE-4779:
----------------------------------------

Michael,
TOK looks great.
It is critical to include examples on most of the topics.  Especially examples that work and easily understandable.  The example included in the current doc is not complete.  Take a look at the attachment Snjezana included here. Need to make sure this whole example is played out in the doc from the begining to end.
Just putting a small snippets is ok, if you show users where they can get the complete sample.



> Birt docs is unusable
> ---------------------
>
>                 Key: JBIDE-4779
>                 URL: https://jira.jboss.org/jira/browse/JBIDE-4779
>             Project: Tools (JBoss Tools)
>          Issue Type: Bug
>          Components: birt
>         Environment: Doesnt matter
>            Reporter: prakash aradhya
>            Assignee: Michael Sorokin
>         Attachments: birtexamples.zip
>
>
> The documentation for Birt integration wtih JBoss tools is completely broken.  Flow of the documentation, language etc are secondary.
> Primarily many of the examples that are included are completely broken.  It would take forever for users to figure out what is missing.
> Example: Page 30 that talks about inserting Birt in Seam pages, is broken.  Where are the files like BirtProductsPDF etc ?
> How do users create those files ?  There are no instruction on how to create them, nor where to obtain them from.

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