The actual "tag reference" pages are mainly mainly a shell for pulling
in the "snippets" from the Javadocs. These are the pages linked from
here:

* http://struts.apache.org/2.x/docs/tag-reference.html

For example, here's what the "source" for the action tag page looks like:

----
{note}Please make sure you have read the [Tag Syntax] document and
understand how tag attribute syntax works.
{note}

h2. Description

{snippet:id=javadoc|javadoc=true|url=org.apache.struts2.components.ActionComponent}

h2. Parameters

{snippet:id=tagattributes|javadoc=false|url=struts2/docs/tags/ActionComponent.html}

h2. Examples

{snippet:id=javacode|javadoc=true|lang=java|url=org.apache.struts2.components.ActionComponent}
{snippet:id=webworkxml|javadoc=true|lang=xml|url=org.apache.struts2.components.ActionComponent}
{snippet:id=example|javadoc=true|lang=xml|url=org.apache.struts2.components.ActionComponent}
----

Much of the documentation brings in content from the Javadocs via the
snippet macro. The tag references pages are an extreme example.

For now, you could set something up on the s2wiki, and we'll port it
over to ww later.

-Ted.


On 12/5/06, Musachy Barroso <[EMAIL PROTECTED]> wrote:
 What I want to edit are the tag references. I'm not sure if they get
created with the snipped macro, they are under

/docs/tags

thanks
musachy

Wendy Smoak wrote:
> On 12/5/06, Musachy Barroso <[EMAIL PROTECTED]> wrote:
>
>> To update the tags documentation, do I need to request rights to edit
>> the pages online? If so, how? Or do I need to send a patch for the stuff
>> under /doc/tags?
>
> Once your CLA is recorded (I believe you said you faxed it yesterday?)
> then one of the admins can grant you access to the 'official'
> documentation wiki.
>
> If the part you're editing is pulled in by the snippet macro, then
> yes, you'd need to submit a patch to the source code.

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to