You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@geronimo.apache.org by chi runhua <ch...@gmail.com> on 2010/12/02 10:35:55 UTC
Incorrect schema docs on Geronimo website
Hi, looked like that the schema docs are not correct for Geronimo 2.2 on the
Geronimo website, because G2.2 schema docs[1] still link to G2.1 schema
pages under a /schema-2.1/docs directory, see [2]. And the oXygen XML
Editor do the real-time transforming to the .xsd files and publish the
result files to Geronimo Website.
[1]. http://geronimo.apache.org/apache-geronimo-v22-xml-schemas.html
[2]. http://geronimo.apache.org/schemas-2.1/docs/geronimo-web-2.0.1.xsd.html
IIUC, we might need to create a folder for each major release such as 2.*,
3.*, and then promote corresponding schema files into the folder, so that
they could be converted and published by the oXygen tool successfully. Does
anyone know where and how to create the folder?
Jeff C
Re: Incorrect schema docs on Geronimo website
Posted by chi runhua <ch...@gmail.com>.
Thanks Shawn. That's really helpful.
I thought those .xsd.html files under /schema-2.1/docs/ directory were
generated automatically, actually they're not. Looks like Hernan or some
other committers did the conversion using oXygen XML editor and then
committed those files.
I also noticed that the copyright information on the bottom of each page is
not correct, which should be copyright(C)2005-2010.
Another thing I didn't figure out yet is that how those .xsd.html files were
generated using the same template as other pages on Geronimo homesite,
because those schema files are not from Confluence wiki thus the .html files
can't be generated using the auto-export plugin. Does this means we have to
update each page manually? If anyone could shed a light on me, that would be
great.
Another thought is we don't generate .html pages for the schema files any
more, we only provide the raw data for the users just like we did for 2.0
version. see
https://svn.apache.org/repos/asf/geronimo/site/trunk/docs/schemas-1.1/
Any thoughts?
Jeff C
On Thu, Dec 2, 2010 at 5:38 PM, Shawn Jiang <ge...@gmail.com> wrote:
> Just take a look at the source tree, [1] might be the place to add.
>
> [1]https://svn.apache.org/repos/asf/geronimo/site/trunk/docs/
>
> On Thu, Dec 2, 2010 at 5:35 PM, chi runhua <ch...@gmail.com> wrote:
> > Hi, looked like that the schema docs are not correct for Geronimo 2.2 on
> the
> > Geronimo website, because G2.2 schema docs[1] still link to G2.1 schema
> > pages under a /schema-2.1/docs directory, see [2]. And the oXygen XML
> > Editor do the real-time transforming to the .xsd files and publish the
> > result files to Geronimo Website.
> >
> > [1]. http://geronimo.apache.org/apache-geronimo-v22-xml-schemas.html
> > [2].
> http://geronimo.apache.org/schemas-2.1/docs/geronimo-web-2.0.1.xsd.html
> >
> > IIUC, we might need to create a folder for each major release such as
> 2.*,
> > 3.*, and then promote corresponding schema files into the folder, so that
> > they could be converted and published by the oXygen tool successfully.
> Does
> > anyone know where and how to create the folder?
> >
> >
> > Jeff C
> >
> >
>
>
>
> --
> Shawn
>
Re: Incorrect schema docs on Geronimo website
Posted by Ivan <xh...@gmail.com>.
I went ahead to add the schema files for 2.2, might need to wait the async
work finishes.
2010/12/2 Shawn Jiang <ge...@gmail.com>
> Just take a look at the source tree, [1] might be the place to add.
>
> [1]https://svn.apache.org/repos/asf/geronimo/site/trunk/docs/
>
> On Thu, Dec 2, 2010 at 5:35 PM, chi runhua <ch...@gmail.com> wrote:
> > Hi, looked like that the schema docs are not correct for Geronimo 2.2 on
> the
> > Geronimo website, because G2.2 schema docs[1] still link to G2.1 schema
> > pages under a /schema-2.1/docs directory, see [2]. And the oXygen XML
> > Editor do the real-time transforming to the .xsd files and publish the
> > result files to Geronimo Website.
> >
> > [1]. http://geronimo.apache.org/apache-geronimo-v22-xml-schemas.html
> > [2].
> http://geronimo.apache.org/schemas-2.1/docs/geronimo-web-2.0.1.xsd.html
> >
> > IIUC, we might need to create a folder for each major release such as
> 2.*,
> > 3.*, and then promote corresponding schema files into the folder, so that
> > they could be converted and published by the oXygen tool successfully.
> Does
> > anyone know where and how to create the folder?
> >
> >
> > Jeff C
> >
> >
>
>
>
> --
> Shawn
>
--
Ivan
Re: Incorrect schema docs on Geronimo website
Posted by Shawn Jiang <ge...@gmail.com>.
Just take a look at the source tree, [1] might be the place to add.
[1]https://svn.apache.org/repos/asf/geronimo/site/trunk/docs/
On Thu, Dec 2, 2010 at 5:35 PM, chi runhua <ch...@gmail.com> wrote:
> Hi, looked like that the schema docs are not correct for Geronimo 2.2 on the
> Geronimo website, because G2.2 schema docs[1] still link to G2.1 schema
> pages under a /schema-2.1/docs directory, see [2]. And the oXygen XML
> Editor do the real-time transforming to the .xsd files and publish the
> result files to Geronimo Website.
>
> [1]. http://geronimo.apache.org/apache-geronimo-v22-xml-schemas.html
> [2]. http://geronimo.apache.org/schemas-2.1/docs/geronimo-web-2.0.1.xsd.html
>
> IIUC, we might need to create a folder for each major release such as 2.*,
> 3.*, and then promote corresponding schema files into the folder, so that
> they could be converted and published by the oXygen tool successfully. Does
> anyone know where and how to create the folder?
>
>
> Jeff C
>
>
--
Shawn