How to update myfaces.apache.org site

[Bill Lucy <wt...@gmail.com>]

Hi all,

I'd like to update one of the web context parameter descriptions at
myfaces.apache.org/core22/myfaces-impl/webconfig.html.  It would be useful
to add information to the javax.faces.INTERPRET_EMPTY_STRING_AS_NULL
parameter, since it doesn't work as expected with EL 3.0.

Is there documentation for how to do this?  I imagine there's more to it
than just updating the corresponding html file in the myfaces-site
repository.

Thanks,
Bill Lucy

Re: How to update myfaces.apache.org site

[Bill Lucy <wt...@gmail.com>]

Ok, that makes a bit more sense than needing to directly update html
files.  Thanks for the instructions.

I already updated the site via direct modification of webconfig.html
yesterday, and that's live.  I've just now updated the comment in UIInput
to reflect the current text on the webconfig page.  Since the updated text
is already live, I'll just wait until the next release to go through a site
deploy.

Bill Lucy

Re: How to update myfaces.apache.org site

[Leonardo Uribe <lu...@gmail.com>]

Hi

The documentation for webconfig.html is generated from the source code.

There is a goal in myfaces-builder-plugin that takes all @JSFWebConfigParam
annotations and sort the params. The intention of this goal is to make
easier the documentation maintenance, and it has worked very well.

So, if you need to update the javadoc of
javax.faces.INTERPRET_EMPTY_STRING_AS_NULL,
just update the comments in javax.faces.UIInput class.

After that, we need to do a site deploy to a local staging directory and
then copy the directory and do a svn commit to:

http://svn.apache.org/repos/asf/myfaces/site/publish/core22

Each myfaces core release involves a site deploy when necessary.

regards,

Leonardo Uribe




2016-10-06 11:03 GMT-05:00 Mike Kienenberger <mk...@gmail.com>:

> I think all that needs to be done is to update the file in svn.   I
> guess if that doesn't work, repost here and someone will speak up.
>
> On Wed, Oct 5, 2016 at 3:50 PM, Bill Lucy <wt...@gmail.com> wrote:
> > Hi all,
> >
> > I'd like to update one of the web context parameter descriptions at
> > myfaces.apache.org/core22/myfaces-impl/webconfig.html.  It would be
> useful
> > to add information to the javax.faces.INTERPRET_EMPTY_STRING_AS_NULL
> > parameter, since it doesn't work as expected with EL 3.0.
> >
> > Is there documentation for how to do this?  I imagine there's more to it
> > than just updating the corresponding html file in the myfaces-site
> > repository.
> >
> > Thanks,
> > Bill Lucy
>

Re: How to update myfaces.apache.org site

[Mike Kienenberger <mk...@gmail.com>]

I think all that needs to be done is to update the file in svn.   I
guess if that doesn't work, repost here and someone will speak up.

On Wed, Oct 5, 2016 at 3:50 PM, Bill Lucy <wt...@gmail.com> wrote:
> Hi all,
>
> I'd like to update one of the web context parameter descriptions at
> myfaces.apache.org/core22/myfaces-impl/webconfig.html.  It would be useful
> to add information to the javax.faces.INTERPRET_EMPTY_STRING_AS_NULL
> parameter, since it doesn't work as expected with EL 3.0.
>
> Is there documentation for how to do this?  I imagine there's more to it
> than just updating the corresponding html file in the myfaces-site
> repository.
>
> Thanks,
> Bill Lucy