Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [birt-dev] Re: birt-dev Digest, Vol 23, Issue 50

Hi Jason,
 
Okay, I'll lay off the website structure for now ;-)  
 
Unfortunately it seems no one else has piped in with a suggestion for the wiki example organization with additional content suggestions or structure.  I was hoping to get more feedback from other folks in the community as well on this.
 
Here are my thoughts based loosely on the structure the two BIRT books use (hopefully you can see my indents?):

 

Data Source

            Accessing and Binding Data

                        Scripted Data Source

                        XML Data Source

                        StoredProcedure

                        JNDI Data Source

 

            Retrieving Data

                        Specifying Data to retrieve from an XML data source

Sorting and Grouping Data

            Grouping

            Nested Groups

            Aggregrating Data

Report Elements

            Nested Tables

            Dynamic Image

Writing Expressions

            BIRT Functions

            Native _javascript_ Functions

Filtering Data

            Best Practices (?) about where to do it...

Scripting

            _javascript_ Event Handlers

            Java Event Handlers

Shared Report Development

            Templates

            Libraries

Charts

            Displaying Data in Charts - Series Definitions (?)

            Adding a Chart to a Report Design(?)

 
It seems to make sense to make some higher level categories, so when people want to add new examples they will understand where to put them.
 
Regards,
 
Susan
----- Original Message ----
From: Jason Weathersby <jasonweathersby@xxxxxxxxxx>
To: birt-dev@xxxxxxxxxxx
Sent: Monday, February 12, 2007 7:43:00 AM
Subject: [birt-dev] Re: birt-dev Digest, Vol 23, Issue 50

Susan,

Thanks for your imput.  The idea is to move the API wiki examples
(http://wiki.eclipse.org/index.php/BIRT2.1/) under the new structure, but
the http://www.eclipse.org/birt/phoenix/deploy/ page would stay as this
gives general descriptions of the APIs.  This page will be reworked
to be less confusing though.  The only examples that would remain on the web
site proper are the flash videos, solution reports, and the tutorial.
I like the idea of further dividing the wiki examples structure.  It would
be nice to get feedback on what the community would like to see.  Ie what
categories am I missing.  I also believe changing the names on the toc to be
more logical is definately needed.

As far as changing the left nav bars etc, I would prefer to hold on this
conversation until we can get a good example structure up that is not
confusing.

Jason


----- Original Message -----
From: <birt-dev-request@xxxxxxxxxxx>
To: <birt-dev@xxxxxxxxxxx>
Sent: Saturday, February 10, 2007 12:00 PM
Subject: birt-dev Digest, Vol 23, Issue 50


> Send birt-dev mailing list submissions to
> birt-dev@xxxxxxxxxxx
>
> To subscribe or unsubscribe via the World Wide Web, visit
> https://dev.eclipse.org/mailman/listinfo/birt-dev
> or, via email, send a message with subject or body 'help' to
> birt-dev-request@xxxxxxxxxxx
>
> You can reach the person managing the list at
> birt-dev-owner@xxxxxxxxxxx
>
> When replying, please edit your Subject line so it is more specific
> than "Re: Contents of birt-dev digest..."
>
>
> Today's Topics:
>
>   1. Re: Wiki Examples (home4slc@xxxxxxxxxxx)
>
>
> ----------------------------------------------------------------------
>
> Message: 1
> Date: Fri, 9 Feb 2007 14:15:51 -0800 (PST)
> From: home4slc@xxxxxxxxxxx
> Subject: Re: [birt-dev] Wiki Examples
> To: Jason Weathersby <jasonweathersby@xxxxxxxxxx>,
> birt-dev@xxxxxxxxxxx
> Message-ID: <143886.6727.qm@xxxxxxxxxxxxxxxxxxxxxxxxxxx>
> Content-Type: text/plain; charset="iso-8859-1"
>
> Hi Jason,
>
> Thanks for providing some more structure for the examples.
>
> I agree that the Stored Procedure page could be split - are you thinking
> about having one page that is a generic Stored Procedure page with links
> to specific examples of Stored Procedures for different databases?  This
> seems good to me.
>
> Also, I agree that this page:
> http://wiki.eclipse.org/index.php/Report_Developer_Examples_%28BIRT%29
> needs some more organization.  Maybe make each major category have it's
> own link (with a brief description of the contents of each category) and
> then have a new page for each category?
>
> I've noticed that the new page encompasses 2 of the top level links on the
> website.
>
> Name on wiki page        Name on WebSite link                URL
> BIRT Tutorial                Tutorial
> http://www.eclipse.org/birt/phoenix/tutorial/
> BIRT Flash Videos        Examples
> http://www.eclipse.org/birt/phoenix/examples/
> (Also, the top level FAQ/Wiki >  FAQ > Examples points to this page.
>
> Will it eventually point to these examples as well?
>
> http://www.eclipse.org/birt/phoenix/deploy/
>
> which is navigated to from the BIRT home page > Integration left frame
> link?
>
> If the new page will point to the
> http://www.eclipse.org/birt/phoenix/deploy/ link, there might not be
> enough room on the new page, and instead it maybe should just contain
> links to the major categories of example types.
>
> Also, I think the name 'BIRT Flash Videos' in the new page is a bit
> misleading because a) some of the other references mentioned above just
> call them 'Examples' and b) they contain a lot more information then just
> Flash Videos.  I'm worried people might not browse that link because of
> the name.  Maybe change the name to 'BIRT Flash Videos and Solution
> Reports'?
>
> An overall question that may help me understand the current organization
> and give input into the structure going forward is the differentiation
> between content placed on the website and content which goes on the wiki.
> I realize that content on the wiki can be edited by anyone with a bugzilla
> id, but I'm thinking more in terms of overall content organization.
>
> Currently I find the organization of examples (regardless of where they
> come from) somewhat confusing, because they seem to reside in several
> different places and I don't understand how they are differentiated.
>
> Where will the new page be referenced from?
>
> On a slightly different topic, I give some input earlier about the
> organization of the web site, and think it is appropriate to discuss it
> here again.
>
> Some of the current categories on the left nav are confusing to me. I'd
> like to suggest that there be some broader categories and then some sub
> categories.  For instance, the broad categories would be based more on the
> type of user that visits the website (user / report developer, contributor
> and committer information), versus the content categories we have now. I
> think this fits in with the redesign of the wiki examples.
>
> Is this something the community is amenable to receiving input on?
>
> Thanks again for doing this Jason, I realize organizing this is time
> consuming and non-trivial.
>
> Regards,
>
> Susan
> ----- Original Message ----
> From: Jason Weathersby <jasonweathersby@xxxxxxxxxx>
> To: birt-dev@xxxxxxxxxxx
> Sent: Friday, February 9, 2007 10:05:58 AM
> Subject: [birt-dev] Wiki Examples
>
>
> I would like to get feedback on the community examples section located
> here:
> http://wiki.eclipse.org/index.php/Examples_%28BIRT%29
>
> Currently there is only one example in the structure which is the stored
> procedure example.
> After looking at that example I think it should be split, one for MySQL
> and another for Derby.
> The TOC for Report Examples needs more as well.
>
> Jason
>
> _______________________________________________
> birt-dev mailing list
> birt-dev@xxxxxxxxxxx
> https://dev.eclipse.org/mailman/listinfo/birt-dev
> -------------- next part --------------
> An HTML attachment was scrubbed...
> URL:
> https://dev.eclipse.org/mailman/listinfo/birt-dev/attachments/20070209/84b887f9/attachment.html
>
> ------------------------------
>
> _______________________________________________
> birt-dev mailing list
> birt-dev@xxxxxxxxxxx
> https://dev.eclipse.org/mailman/listinfo/birt-dev
>
>
> End of birt-dev Digest, Vol 23, Issue 50
> ****************************************

_______________________________________________
birt-dev mailing list
birt-dev@xxxxxxxxxxx
https://dev.eclipse.org/mailman/listinfo/birt-dev


Back to the top