You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cocoon.apache.org by Vadim Gritsenko <va...@verizon.net> on 2002/01/15 05:41:39 UTC

Reorganizing Samples

Hi,

I would like to re-organize samples shipped with Cocoon: divide them on
separate pages, each of these should fit into the screen or so, but not
so huge as current examples page.

I see following parts on the first welcome page:

  <group name="Multimedia Hello World">
    - as is,

  <group name="Documentation">
    - with the additions:
   <sample name="Slides" href="slides/slides">
    Presentation shown at ApacheCon 2000. (Example of complex XSLT
usage)
   </sample>
   <sample name="Search the docs" href="search/welcome">
    Search into the cocoon documentation using Apache Lucene.
   </sample>

  <group name="More Samples">
    - will have links to other pages:
      <sample name="Static Content" href="sample-static">
      <sample name="Dynamic Content" href="sample-dynamic">
      <sample name="Sources" href="sub/">
      <sample name="Web Applications" href="sample-apps">

  <group name="System Tools And Pages">
    - with the addition:
   <sample name="Sitemap Editor" href="sitebuilder/openSubSite/">
    Cocoon/JSP based Sitemap Editor.
   </sample>

Any comments, suggestions or critics?

Vadim



---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org


RE: Reorganizing Samples

Posted by Vadim Gritsenko <va...@verizon.net>.
> From: Stefano Mazzocchi [mailto:stefano@apache.org]
> 
> > I see following parts on the first welcome page:
> 
> I'd love to have the welcome page being the cocoon home page in the
docs
> (the same that will be up into xml.apache.org/cocoon/ and not the
> samples!

Why not... However, one might say that if we follow the example of
Apache HTTPD, Resin, Tomcat, etc, first page user sees is not a
documentation, but something different, with the link to the
documentation.
I do not have strong preference for any of these two ways...


> >    <sample name="Slides" href="slides/slides">
> >     Presentation shown at ApacheCon 2000. (Example of complex XSLT
> > usage)
> >    </sample>
> 
> This is talking about Cocoo1, could be misleading in the 'docs'
section,
> shouldn't it?

Ahem. Care to donate more recent version? ;)


> >   <group name="More Samples">
> >       <sample name="Sources" href="sub/">
> 
> what is this?

Sometime ago I put together several (I hope) useful examples of cocoon:
protocol usage. It was primarily used by me to test this, but now I
sometimes recommend users to take a look there to understand
possibilities.

 
> >   <group name="System Tools And Pages">
> >     - with the addition:
> >    <sample name="Sitemap Editor" href="sitebuilder/openSubSite/">
> >     Cocoon/JSP based Sitemap Editor.
> >    </sample>
> 
> Shouldn't move the sitemap editor into the 'scratchpad' and remove it
> from the samples?
> 
> I'm not sure I like it there, it seems to be giving the wrong
impression
> of something unfinished that went there to show off.

Good point. I have not seen any development on this app since (IIRC) it
get into CVS...


Regards,
Vadim



---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org


Re: Reorganizing Samples

Posted by Stefano Mazzocchi <st...@apache.org>.
Vadim Gritsenko wrote:
> 
> Hi,
> 
> I would like to re-organize samples shipped with Cocoon: divide them on
> separate pages, each of these should fit into the screen or so, but not
> so huge as current examples page.

Good point.

> I see following parts on the first welcome page:

I'd love to have the welcome page being the cocoon home page in the docs
(the same that will be up into xml.apache.org/cocoon/ and not the
samples!

Live samples should a link from there (that will be reflected on the
site once we have forrest running on top of cocoon to host
xml.apache.org)

>   <group name="Multimedia Hello World">
>     - as is,
> 
>   <group name="Documentation">
>     - with the additions:
>    <sample name="Slides" href="slides/slides">
>     Presentation shown at ApacheCon 2000. (Example of complex XSLT
> usage)
>    </sample>

This is talking about Cocoo1, could be misleading in the 'docs' section,
shouldn't it?

>    <sample name="Search the docs" href="search/welcome">
>     Search into the cocoon documentation using Apache Lucene.
>    </sample>

Doc searching should be done at the homepage level.

I would remove the 'documentation' section entirely.

>   <group name="More Samples">
>     - will have links to other pages:
>       <sample name="Static Content" href="sample-static">
>       <sample name="Dynamic Content" href="sample-dynamic">
>       <sample name="Sources" href="sub/">

what is this?

>       <sample name="Web Applications" href="sample-apps">

>   <group name="System Tools And Pages">
>     - with the addition:
>    <sample name="Sitemap Editor" href="sitebuilder/openSubSite/">
>     Cocoon/JSP based Sitemap Editor.
>    </sample>

Shouldn't move the sitemap editor into the 'scratchpad' and remove it
from the samples?

I'm not sure I like it there, it seems to be giving the wrong impression
of something unfinished that went there to show off.

Thoughts?

-- 
Stefano Mazzocchi      One must still have chaos in oneself to be
                          able to give birth to a dancing star.
<st...@apache.org>                             Friedrich Nietzsche
--------------------------------------------------------------------


---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org