You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@sis.apache.org by Martin Desruisseaux <ma...@geomatys.fr> on 2013/07/25 00:33:07 UTC
Large web site update in staging area
As part of the release process, the SIS web site got a large update, for
now visible only in the staging area:
http://sis.staging.apache.org/index.html
Notable changes:
* Content of some Maven pages moved to "downloads", "source codes" and
"branches". More will be moved later.
* The "release management" page has been adapted to SIS (thanks Suresh
for the initial version!)
* "Web site management" page added.
* Release notes added: http://sis.staging.apache.org/release-notes/
(not yet nicely formatted)
Open issues:
* The menu on the left side does not fully work (it didn't worked in
the original version neither). I created a JIRA task giving more
details [1].
* I don't know how to use "Markdown" and the templates in
sub-directories... (for now, the directory structure is mostly flat).
If any one have any clue about the above, that would be appreciated.
Martin
[1] http://issues.apache.org/jira/browse/SIS-114
Re: Large web site update in staging area
Posted by Martin Desruisseaux <ma...@geomatys.fr>.
Le 25/07/13 20:30, Mattmann, Chris A (398J) a écrit :
> This is awesome, publish it! No worries about minor potential issues,
> this is still a huge improvement!
Done, thanks!
Martin
Re: Large web site update in staging area
Posted by "Mattmann, Chris A (398J)" <ch...@jpl.nasa.gov>.
This is awesome, publish it! No worries about minor potential issues,
this is still a huge improvement!
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Chris Mattmann, Ph.D.
Senior Computer Scientist
NASA Jet Propulsion Laboratory Pasadena, CA 91109 USA
Office: 171-266B, Mailstop: 171-246
Email: chris.a.mattmann@nasa.gov
WWW: http://sunset.usc.edu/~mattmann/
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Adjunct Assistant Professor, Computer Science Department
University of Southern California, Los Angeles, CA 90089 USA
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-----Original Message-----
From: Martin Desruisseaux <ma...@geomatys.fr>
Organization: Geomatys
Reply-To: "dev@sis.apache.org" <de...@sis.apache.org>
Date: Thursday, July 25, 2013 6:49 AM
To: "dev@sis.apache.org" <de...@sis.apache.org>
Subject: Re: Large web site update in staging area
>I ported two more pages to CMS, which I removed from Maven APT pages:
>
> http://sis.staging.apache.org/code-patterns.html
> http://sis.staging.apache.org/faq.html
>
>I also specified explicitly the anchors in every headers of every pages.
>The intend is to have more stable anchors if the SIS site is referenced
>by external sites.
>
>Do peoples agree for publishing those modifications?
>
>At first I was considering a mix of Maven and CMS pages. But given that
>CMS appears to be more flexible than APT/FML and reasonably easy once we
>get familiar with it, I propose to migrate everything to CMS and remove
>the corresponding documentation from the Maven site, in the hope to
>simplify maintenance. The main inconvenient I can see is that some
>manually generated CMS pages may lag behind the automatically generated
>Maven pages (team list, mailing lists, source code repository). However
>this is a minor concern if those pages do not change often. An other
>slight inconvenience is that if a class is moved or deleted, we must
>remember to perform a search in the web site repository in addition to
>the Java code repository.
>
> Martin
>
Re: Large web site update in staging area
Posted by Martin Desruisseaux <ma...@geomatys.fr>.
I ported two more pages to CMS, which I removed from Maven APT pages:
http://sis.staging.apache.org/code-patterns.html
http://sis.staging.apache.org/faq.html
I also specified explicitly the anchors in every headers of every pages.
The intend is to have more stable anchors if the SIS site is referenced
by external sites.
Do peoples agree for publishing those modifications?
At first I was considering a mix of Maven and CMS pages. But given that
CMS appears to be more flexible than APT/FML and reasonably easy once we
get familiar with it, I propose to migrate everything to CMS and remove
the corresponding documentation from the Maven site, in the hope to
simplify maintenance. The main inconvenient I can see is that some
manually generated CMS pages may lag behind the automatically generated
Maven pages (team list, mailing lists, source code repository). However
this is a minor concern if those pages do not change often. An other
slight inconvenience is that if a class is moved or deleted, we must
remember to perform a search in the web site repository in addition to
the Java code repository.
Martin
Re: Large web site update in staging area
Posted by Martin Desruisseaux <ma...@geomatys.fr>.
Le 25/07/13 08:19, Mattmann, Chris A (398J) a écrit :
> +1 to the changes even with the small bugs you mention. New site
> looks great, publish it!
Thanks, done :-). Before to publish, I downgraded the "latest release"
version from 0.3 to 0.2-incubating since 0.3 is not yet released.
Martin
Re: Large web site update in staging area
Posted by "Mattmann, Chris A (398J)" <ch...@jpl.nasa.gov>.
+1 to the changes even with the small bugs you mention. New site
looks great, publish it!
Cheers,
Chris
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Chris Mattmann, Ph.D.
Senior Computer Scientist
NASA Jet Propulsion Laboratory Pasadena, CA 91109 USA
Office: 171-266B, Mailstop: 171-246
Email: chris.a.mattmann@nasa.gov
WWW: http://sunset.usc.edu/~mattmann/
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Adjunct Assistant Professor, Computer Science Department
University of Southern California, Los Angeles, CA 90089 USA
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-----Original Message-----
From: Martin Desruisseaux <ma...@geomatys.fr>
Organization: Geomatys
Reply-To: "dev@sis.apache.org" <de...@sis.apache.org>
Date: Wednesday, July 24, 2013 3:33 PM
To: Apache SIS <de...@sis.apache.org>
Subject: Large web site update in staging area
>As part of the release process, the SIS web site got a large update, for
>now visible only in the staging area:
>
>http://sis.staging.apache.org/index.html
>
>Notable changes:
>
> * Content of some Maven pages moved to "downloads", "source codes" and
> "branches". More will be moved later.
> * The "release management" page has been adapted to SIS (thanks Suresh
> for the initial version!)
> * "Web site management" page added.
> * Release notes added: http://sis.staging.apache.org/release-notes/
> (not yet nicely formatted)
>
>
>Open issues:
>
> * The menu on the left side does not fully work (it didn't worked in
> the original version neither). I created a JIRA task giving more
> details [1].
> * I don't know how to use "Markdown" and the templates in
> sub-directories... (for now, the directory structure is mostly flat).
>
>
>If any one have any clue about the above, that would be appreciated.
>
> Martin
>
>[1] http://issues.apache.org/jira/browse/SIS-114
>