J Aaron Farr wrote:
Now that I'm at a normal keyboard, perhaps I can be a little more clear. I've
been thinking about how to visually describe the Avalon framework to new users.
Something that people could view on the website that would clarify how all the
pieces of the puzzle fit together. For example, look at our "Products" page:
http://avalon.apache.org/product/index.html. It's okay, but wouldn't it be nice
if there were a visual representation of this as well?
When you have something as difficult to describe as Avalon, the most important
thing is to give the "big" picture. If you try to give all the details in one
shot you are going to miss the mark on something easy to understand.
The products page only has three things in the list. It would be good to
provide a diagram on that page that visually describes their relation to
each other, but no more.
When you are on the Merlin page, you can have something that visually describes
the major pieces of Merlin--being very careful not to contradict the first
diagram.
When you are on the Framework page, you would have something that visually
describes how Framework works with the users components, no more.
When you are on the "Planet" page, then you would, again, have something that
might describe the relationhip that each of the components would have with each
other. However, that might have to be split into sets of components that
interrelate instead of one huge one that has islands of information.
Of course the problem is that visually describing Avalon is hard. Getting the
scope right is hard. Showing a simple desciption while at the same time
representing Avalon's dynamic nature is hard. Several very different diagrams
could all describe valid deployment scenerios.
Perhaps what we need is a "Diagram Contest" like all those logo contests
projects have. :)
What we need are a set of diagrams, one just won't work right. Just spread them
out. WIth components that interrelate, you can have the same basic diagram, but
highlight the one that we are talking about on the page.
Kind of like a "drill" down way of getting more specific information when we
need it.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
