You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@cocoon.apache.org by Nicola Ken Barozzi <ni...@apache.org> on 2002/06/28 14:09:36 UTC

[USER POLL] New cocoon-docs mailing list?

The Cocoon documentation project has started with the great help of 
Diana Shannon, and is gaining good momentum and interest  :-)

In case you don't already know, on the dev list we have decided that a 
cocoon-docs mailing list could help this subproject and facilitate 
contributors.

We are *seriously* committed to Cocoon, and to the *best* documentation 
it can have.

          *******************************************************

           Users, do you think it's time for a cocoon-docs list?

          *******************************************************


-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


---------------------------------------------------------------------
Please check that your question  has not already been answered in the
FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>

To unsubscribe, e-mail:     <co...@xml.apache.org>
For additional commands, e-mail:   <co...@xml.apache.org>


Re: [USER POLL] New cocoon-docs mailing list?

Posted by Liam Morley <lm...@gdc.wpi.edu>.
I definitely see a need to focus heavily on documentation, and if such a 
list would have that result, I'm certainly all for it.

Liam Morley

Nicola Ken Barozzi wrote:

> The Cocoon documentation project has started with the great help of 
> Diana Shannon, and is gaining good momentum and interest  :-)
>
> In case you don't already know, on the dev list we have decided that a 
> cocoon-docs mailing list could help this subproject and facilitate 
> contributors.
>
> We are *seriously* committed to Cocoon, and to the *best* 
> documentation it can have.
>
>          *******************************************************
>
>           Users, do you think it's time for a cocoon-docs list?
>
>          *******************************************************
>
>



---------------------------------------------------------------------
Please check that your question  has not already been answered in the
FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>

To unsubscribe, e-mail:     <co...@xml.apache.org>
For additional commands, e-mail:   <co...@xml.apache.org>


Re: [USER POLL] New cocoon-docs mailing list?

Posted by "Andrew C. Oliver" <ac...@apache.org>.
>
>          *******************************************************
>
>           Users, do you think it's time for a cocoon-docs list?
>
>          *******************************************************
>

-1 -  I consider myself 3/4 cocoon user and 1/4 developer.  So count my 
vote for 3/4.  I think
having a cocoon-docs list will detract from the goal of having 
documentation.  Certain personalities
in the group will be able to avoid the documentation issue entirely, 
where keeping the development
concerns (meaning the development of documentation) IN the development 
list will keep the issue in
their face.

I'll only vote for it if the list can be called 
cocoon-lets-brush-documentation-under-the-rug@xml.apache.org
which in my opinion would be what the list was for!  (despite any best 
intentions).

-Andy




---------------------------------------------------------------------
Please check that your question  has not already been answered in the
FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>

To unsubscribe, e-mail:     <co...@xml.apache.org>
For additional commands, e-mail:   <co...@xml.apache.org>


Re: web-app tutorial

Posted by "Andrew C. Oliver" <ac...@apache.org>.
Thats what XML-Form + actions does.  Take a closer look at the the 
how-to.  I was able to cut and
paste that code pretty quckly.  I've written a hello-XML-form example 
but I haven't had time to formalize it.

-Andy

>This outlines the kind of thing I'd like to be able to do.
>
>--
>public class GuessGame {
>   private int target, guess, steps = 0;
>   private boolean hasGuessed;
>   private String action; // value of form submit
>
>   public GuessGame() {
>      this.target = (int)Math.random(100);
>   }
>
>   public void setAction(String action) {
>      this.action = action;
>   }
> 
>   public String getMode() {
>      if(action.equals("Cancel")) return "cancel";
>      else if(haveGuessed) {
>         return (guess == target) ? "final" : "guessing";
>      } else return "initial";
>   }
>
>   public int getGuess() {
>      return guess;
>   }
>  
>   public void setGuess(int guess) {
>      this.guess = guess;
>      haveGuessed = true;
>      ++steps;
>   }
>}
>--
><%-- Have some way to map requests to bean logic.
>     With the bean data available to the stylesheet. 
>  --%>
><jsp:useBean name="game" class="GuessGame" scope="session"/>
><jsp:setProperty id="game" name="*"/>
>
>--
><xsl:stylesheet>
>
>   <xsl:template match="game" mode="initial">
>     Hit Next to begin the game or Quit to close.
>     <form>
>        <input type="submit" name="action" value="Next"/>
>        <input type="submit" name="action" value="Quit"/>
>     </form>
>   </xsl:template>
>
>   <xsl:template match="game" mode="guessing">
>     Sorry! <xsl:value-of select="@guess"/> was
>     <xsl:choose>
>        <xsl:when test="@guess &gt; @target">
>          too high.
>        </xsl:when>
>        <xsl:otherwise>
>           too low.
>        </xsl:otherwise>
>     </xsl:choose>
>
>     Guess again.
>
>     <form>
>        <input type="text" name="guess" value="{@guess}"/>
>        <input type="submit" name="action" value="Next"/>
>        <input type="submit" name="action" value="Quit"/>
>     </form>
>   </xsl:template>
>
>   <xsl:template match="game" mode="final">
>     You got it in <xsl:value-of select="@steps"/> steps!
>     <form>
>        <input type="submit" name="action" value="Quit"/>
>     </form>
>   </xsl:template>
>
>   <xsl:template match="game" mode="quit">
>      Thanks for playing.
>   </xsl:template>
></xsl:stylesheet>
>--
>
>Anyways, I'd like to do something like that, but what components go in the 
>middle between beans and xsl is a mystery....
>
>
>
>---------------------------------------------------------------------
>Please check that your question  has not already been answered in the
>FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>
>
>To unsubscribe, e-mail:     <co...@xml.apache.org>
>For additional commands, e-mail:   <co...@xml.apache.org>
>
>
>  
>




---------------------------------------------------------------------
Please check that your question  has not already been answered in the
FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>

To unsubscribe, e-mail:     <co...@xml.apache.org>
For additional commands, e-mail:   <co...@xml.apache.org>


web-app tutorial

Posted by Guy McArthur <gu...@guymcarthur.com>.
I like some of the things in the tutorial, but I don't want to do XForms, 
or XSP, or describe form validation in XML. Just want to map requests to 
java beans. Beans set their mode (state) as a parameter to the stylesheet, 
and the stylesheet has templates for each mode. The useBean syntax of jsp 
makes it easy, but if the cocoon sitemap can do that too, eliminating the 
jsp would be good.

What would be ideal, is using JXPath and eliminating the bean marshalling 
to xml step altogether.

It seems like Actions could do this, but it's unclear....

Say for a simple example, a "guess a number" web application with one bean
and one corresponding stylesheet.

This outlines the kind of thing I'd like to be able to do.

--
public class GuessGame {
   private int target, guess, steps = 0;
   private boolean hasGuessed;
   private String action; // value of form submit

   public GuessGame() {
      this.target = (int)Math.random(100);
   }

   public void setAction(String action) {
      this.action = action;
   }
 
   public String getMode() {
      if(action.equals("Cancel")) return "cancel";
      else if(haveGuessed) {
         return (guess == target) ? "final" : "guessing";
      } else return "initial";
   }

   public int getGuess() {
      return guess;
   }
  
   public void setGuess(int guess) {
      this.guess = guess;
      haveGuessed = true;
      ++steps;
   }
}
--
<%-- Have some way to map requests to bean logic.
     With the bean data available to the stylesheet. 
  --%>
<jsp:useBean name="game" class="GuessGame" scope="session"/>
<jsp:setProperty id="game" name="*"/>

--
<xsl:stylesheet>

   <xsl:template match="game" mode="initial">
     Hit Next to begin the game or Quit to close.
     <form>
        <input type="submit" name="action" value="Next"/>
        <input type="submit" name="action" value="Quit"/>
     </form>
   </xsl:template>

   <xsl:template match="game" mode="guessing">
     Sorry! <xsl:value-of select="@guess"/> was
     <xsl:choose>
        <xsl:when test="@guess &gt; @target">
          too high.
        </xsl:when>
        <xsl:otherwise>
           too low.
        </xsl:otherwise>
     </xsl:choose>

     Guess again.

     <form>
        <input type="text" name="guess" value="{@guess}"/>
        <input type="submit" name="action" value="Next"/>
        <input type="submit" name="action" value="Quit"/>
     </form>
   </xsl:template>

   <xsl:template match="game" mode="final">
     You got it in <xsl:value-of select="@steps"/> steps!
     <form>
        <input type="submit" name="action" value="Quit"/>
     </form>
   </xsl:template>

   <xsl:template match="game" mode="quit">
      Thanks for playing.
   </xsl:template>
</xsl:stylesheet>
--

Anyways, I'd like to do something like that, but what components go in the 
middle between beans and xsl is a mystery....



---------------------------------------------------------------------
Please check that your question  has not already been answered in the
FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>

To unsubscribe, e-mail:     <co...@xml.apache.org>
For additional commands, e-mail:   <co...@xml.apache.org>


Re: [USER POLL] New cocoon-docs mailing list?

Posted by Martin Stricker <sh...@gmx.de>.
Nicola Ken Barozzi wrote:

>            Users, do you think it's time for a cocoon-docs list?

-0
Documentation (at least the first draft) is best written by the person
who is most accustomed to the code, so that's usually the developer
her/himself. So I *think* cocoon-dev is the best place to discuss
documentation issues. However, as long as no developer
*ignores/"forgets"* documentation, if documentation issues come to a
huge mail count, a separate mailing list *might* be useful. Hence the
negative zero vote...

Best regards,
Martin Stricker
-- 
Homepage: http://www.martin-stricker.de/
Webmaster-Forum: http://www.masterportal24.com/cgi-bin/YaBB.cgi
Red Hat Linux 7.2 for low memory: http://www.rule-project.org/
Registered Linux user #210635: http://counter.li.org/

---------------------------------------------------------------------
Please check that your question  has not already been answered in the
FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>

To unsubscribe, e-mail:     <co...@xml.apache.org>
For additional commands, e-mail:   <co...@xml.apache.org>


Re: [USER POLL] New cocoon-docs mailing list?

Posted by Mike Haarman <mh...@socsci.umn.edu>.
+1

There is no reason for Cocoon not to be the best documented package
under //xml.apache.org/  The pipeline for documentation should be the best
example of how to use the system.

And somehow, documenting the documentation system seems quite in spirit
with the project and its markup foundation: all things consumed in an
ever-widening vortex of referentiality.

----------------------------------------------------------------
Mike Haarman
mhaarma@socsci.umn.edu

Maintainer,
  DDI Codebook DTD -- http://www.icpsr.umich.edu/DDI/


---------------------------------------------------------------------
Please check that your question  has not already been answered in the
FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>

To unsubscribe, e-mail:     <co...@xml.apache.org>
For additional commands, e-mail:   <co...@xml.apache.org>


Re: [COCOON] New cocoon-docs mailing list

Posted by Nicola Ken Barozzi <ni...@apache.org>.
Sam Ruby wrote:
> Nicola Ken Barozzi wrote:
> 
>> Dear PMC, Dear root,
>>
>> The Cocoon project asks for the creation of a new mailing list to aid 
>> the new Cocoon Documentation project.
>>
>>          cocoon-docs@xml.apache.org
> 
> List created, Initial moderator is nicolaken@apache.org.

Thank you, Sam! :-)

For all users and developers that want to work on the documentation, 
just send an empty mail to:


        cocoon-docs-subscribe@xml.apache.org


Let's roll! :-D

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


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


Re: [COCOON] New cocoon-docs mailing list

Posted by Nicola Ken Barozzi <ni...@apache.org>.
Sam Ruby wrote:
> Nicola Ken Barozzi wrote:
> 
>> Dear PMC, Dear root,
>>
>> The Cocoon project asks for the creation of a new mailing list to aid 
>> the new Cocoon Documentation project.
>>
>>          cocoon-docs@xml.apache.org
> 
> List created, Initial moderator is nicolaken@apache.org.

Thank you, Sam! :-)

For all users and developers that want to work on the documentation, 
just send an empty mail to:


        cocoon-docs-subscribe@xml.apache.org


Let's roll! :-D

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


---------------------------------------------------------------------
Please check that your question  has not already been answered in the
FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>

To unsubscribe, e-mail:     <co...@xml.apache.org>
For additional commands, e-mail:   <co...@xml.apache.org>


Re: [COCOON] New cocoon-docs mailing list

Posted by Nicola Ken Barozzi <ni...@apache.org>.
Sam Ruby wrote:
> Nicola Ken Barozzi wrote:
> 
>> Dear PMC, Dear root,
>>
>> The Cocoon project asks for the creation of a new mailing list to aid 
>> the new Cocoon Documentation project.
>>
>>          cocoon-docs@xml.apache.org
> 
> List created, Initial moderator is nicolaken@apache.org.

Thank you, Sam! :-)

For all users and developers that want to work on the documentation, 
just send an empty mail to:


        cocoon-docs-subscribe@xml.apache.org


Let's roll! :-D

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


Re: [COCOON] New cocoon-docs mailing list

Posted by Sam Ruby <ru...@intertwingly.net>.
Nicola Ken Barozzi wrote:

> Dear PMC, Dear root,
>
> The Cocoon project asks for the creation of a new mailing list to aid 
> the new Cocoon Documentation project.
>
>          cocoon-docs@xml.apache.org


List created, Initial moderator is nicolaken@apache.org.

- Sam Ruby

P.S.  No need to bother root for mail requests, apmail@apache.org will do.


---------------------------------------------------------------------
Please check that your question  has not already been answered in the
FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>

To unsubscribe, e-mail:     <co...@xml.apache.org>
For additional commands, e-mail:   <co...@xml.apache.org>


Re: [COCOON] New cocoon-docs mailing list

Posted by Sam Ruby <ru...@intertwingly.net>.
Nicola Ken Barozzi wrote:

> Dear PMC, Dear root,
>
> The Cocoon project asks for the creation of a new mailing list to aid 
> the new Cocoon Documentation project.
>
>          cocoon-docs@xml.apache.org


List created, Initial moderator is nicolaken@apache.org.

- Sam Ruby

P.S.  No need to bother root for mail requests, apmail@apache.org will do.


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


[COCOON] New cocoon-docs mailing list

Posted by Nicola Ken Barozzi <ni...@apache.org>.
Dear PMC, Dear root,

The Cocoon project asks for the creation of a new mailing list to aid 
the new Cocoon Documentation project.

          cocoon-docs@xml.apache.org

This project will stand for Cocoon as the HTTP Server Documentation 
Project does with the HTTP Server Project.

For coordinating the project, Diana Shannon has already been made 
committer with a very big number of votes, and is working very actively 
with the collaboration of both users and developers.

http://marc.theaimsgroup.com/?t=101896493700004&r=1&w=2


The creation of this list has been voted positively by the developer 
list after some discussion, since we were not sure that there was a 
community of doc writers for Cocoon.

+1  6 votes from committers, 3 from users-developers
+0  3 votes

http://marc.theaimsgroup.com/?t=102068666400002&r=1&w=2


Because of this, we have not asked for the creation of the list right 
away, waiting instead to see how much involvement the doc effort was 
able to generate.

These weeks have clearly shown that there is a great need for better 
documetation and a good number of users and developers already working 
on it with success.
In fact the volume of the documentation mails has recently topped the 
one of other topics on the user list.

Because of this, we asked the users if it was time to start the docs list.

> At 14:09 28/06/2002 +0200, Nicola Ken Barozzi wrote:
> 
>> The Cocoon documentation project has started with the great help of 
>> Diana Shannon, and is gaining good momentum and interest  :-)
>>
>> In case you don't already know, on the dev list we have decided that a 
>> cocoon-docs mailing list could help this subproject and facilitate 
>> contributors.
>>
>> We are *seriously* committed to Cocoon, and to the *best* 
>> documentation it can have.
>>
>>          *******************************************************
>>
>>           Users, do you think it's time for a cocoon-docs list?
>>
>>          *******************************************************

Result of this poll was

+1  9 votes
-0  1 vote
-1  1 vote

http://marc.theaimsgroup.com/?t=102526636100001&r=1&w=2

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


---------------------------------------------------------------------
Please check that your question  has not already been answered in the
FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>

To unsubscribe, e-mail:     <co...@xml.apache.org>
For additional commands, e-mail:   <co...@xml.apache.org>


[COCOON] New cocoon-docs mailing list

Posted by Nicola Ken Barozzi <ni...@apache.org>.
Dear PMC, Dear root,

The Cocoon project asks for the creation of a new mailing list to aid 
the new Cocoon Documentation project.

          cocoon-docs@xml.apache.org

This project will stand for Cocoon as the HTTP Server Documentation 
Project does with the HTTP Server Project.

For coordinating the project, Diana Shannon has already been made 
committer with a very big number of votes, and is working very actively 
with the collaboration of both users and developers.

http://marc.theaimsgroup.com/?t=101896493700004&r=1&w=2


The creation of this list has been voted positively by the developer 
list after some discussion, since we were not sure that there was a 
community of doc writers for Cocoon.

+1  6 votes from committers, 3 from users-developers
+0  3 votes

http://marc.theaimsgroup.com/?t=102068666400002&r=1&w=2


Because of this, we have not asked for the creation of the list right 
away, waiting instead to see how much involvement the doc effort was 
able to generate.

These weeks have clearly shown that there is a great need for better 
documetation and a good number of users and developers already working 
on it with success.
In fact the volume of the documentation mails has recently topped the 
one of other topics on the user list.

Because of this, we asked the users if it was time to start the docs list.

> At 14:09 28/06/2002 +0200, Nicola Ken Barozzi wrote:
> 
>> The Cocoon documentation project has started with the great help of 
>> Diana Shannon, and is gaining good momentum and interest  :-)
>>
>> In case you don't already know, on the dev list we have decided that a 
>> cocoon-docs mailing list could help this subproject and facilitate 
>> contributors.
>>
>> We are *seriously* committed to Cocoon, and to the *best* 
>> documentation it can have.
>>
>>          *******************************************************
>>
>>           Users, do you think it's time for a cocoon-docs list?
>>
>>          *******************************************************

Result of this poll was

+1  9 votes
-0  1 vote
-1  1 vote

http://marc.theaimsgroup.com/?t=102526636100001&r=1&w=2

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


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


Re: [USER POLL] New cocoon-docs mailing list?

Posted by Bert Van Kets <be...@vankets.com>.
+1 from me.  Maybe some more users (me included) will get some more focus 
on docs.  I have some texts laying around I need to finish to be useful.
Bert


At 14:09 28/06/2002 +0200, you wrote:
>The Cocoon documentation project has started with the great help of Diana 
>Shannon, and is gaining good momentum and interest  :-)
>
>In case you don't already know, on the dev list we have decided that a 
>cocoon-docs mailing list could help this subproject and facilitate 
>contributors.
>
>We are *seriously* committed to Cocoon, and to the *best* documentation it 
>can have.
>
>          *******************************************************
>
>           Users, do you think it's time for a cocoon-docs list?
>
>          *******************************************************
>
>
>--
>Nicola Ken Barozzi                   nicolaken@apache.org
>             - verba volant, scripta manent -
>    (discussions get forgotten, just code remains)
>---------------------------------------------------------------------
>
>
>---------------------------------------------------------------------
>Please check that your question  has not already been answered in the
>FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>
>
>To unsubscribe, e-mail:     <co...@xml.apache.org>
>For additional commands, e-mail:   <co...@xml.apache.org>


---------------------------------------------------------------------
Please check that your question  has not already been answered in the
FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>

To unsubscribe, e-mail:     <co...@xml.apache.org>
For additional commands, e-mail:   <co...@xml.apache.org>