Now that we have multiple branches of docs (1.7.x, 2.0.x, trunk) not to mention the individual versions of the docs versions, I see that this can cause difficulties finding the right information when searching (through Google or otherwise). Today I did a search for "REST API GeoServer" and the top link was for Confluence (natch), but the second link was for 1.7.x. The "stable" branch (2.0.x) was not on the list.
With this in mind, I propose to add new docs URL aliases (leaving the current links as is, for when we need to link to some specific branch):
http://docs.geoserver.org/stable
(for the current stable branch, now 2.0.x)
http://docs.geoserver.org/unstable
(for trunk)
That way, we can start to sync up our doc links, so we can improve searches, help people get to the latest and greatest information, and hopefully start to bury the docs in Confluence once and for all! 
Thoughts?
Thanks,
Mike Pumphrey
OpenGeo - http://opengeo.org
Would it be possible to add a link/block to all the docs - so all docs
have a link to a permanent URL for the current stable branch and trunk
versions?
This would
a) help people find the right version
b) let people know there are multiple versions
c) allow people wondering about specific functionality to quickly
traverse to see if its been changed in upcoming versions?
Rob
On Thu, Jan 21, 2010 at 6:46 AM, Mike Pumphrey <mike@anonymised.com> wrote:
Now that we have multiple branches of docs (1.7.x, 2.0.x, trunk) not to mention the individual versions of the docs versions, I see that this can cause difficulties finding the right information when searching (through Google or otherwise). Today I did a search for "REST API GeoServer" and the top link was for Confluence (natch), but the second link was for 1.7.x. The "stable" branch (2.0.x) was not on the list.
With this in mind, I propose to add new docs URL aliases (leaving the current links as is, for when we need to link to some specific branch):
http://docs.geoserver.org/stable
(for the current stable branch, now 2.0.x)
http://docs.geoserver.org/unstable
(for trunk)
That way, we can start to sync up our doc links, so we can improve searches, help people get to the latest and greatest information, and hopefully start to bury the docs in Confluence once and for all!
Thoughts?
Thanks,
Mike Pumphrey
OpenGeo - http://opengeo.org
------------------------------------------------------------------------------
Throughout its 18-year history, RSA Conference consistently attracts the
world's best and brightest in the field, creating opportunities for Conference
attendees to learn about information security's most important issues through
interactions with peers, luminaries and emerging and established companies.
http://p.sf.net/sfu/rsaconf-dev2dev
_______________________________________________
Geoserver-devel mailing list
Geoserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel
Mike Pumphrey ha scritto:
Now that we have multiple branches of docs (1.7.x, 2.0.x, trunk) not
to mention the individual versions of the docs versions, I see that
this can cause difficulties finding the right information when
searching (through Google or otherwise). Today I did a search for
"REST API GeoServer" and the top link was for Confluence (natch), but
the second link was for 1.7.x. The "stable" branch (2.0.x) was not
on the list.
I have the impression that confluence still has more Google juice,
maybe due to better usage of adwords, keywords and the like.
It also does not help that the sphinx docs are severely incomplete
in a few parts (SLD/WMS comes to mind)
With this in mind, I propose to add new docs URL aliases (leaving the
current links as is, for when we need to link to some specific
branch):
http://docs.geoserver.org/stable (for the current stable branch, now
2.0.x) http://docs.geoserver.org/unstable (for trunk)
These aliases work for me
Cheers
Andrea
--
Andrea Aime
OpenGeo - http://opengeo.org
Expert service straight from the developers.
Sorry, I'm not really sure what you mean by this. Could you elaborate and/or give an example?
Thanks,
Mike Pumphrey
OpenGeo - http://opengeo.org
Rob Atkinson wrote:
Would it be possible to add a link/block to all the docs - so all docs
have a link to a permanent URL for the current stable branch and trunk
versions?
This would
a) help people find the right version
b) let people know there are multiple versions
c) allow people wondering about specific functionality to quickly
traverse to see if its been changed in upcoming versions?
Rob
On Thu, Jan 21, 2010 at 6:46 AM, Mike Pumphrey <mike@anonymised.com> wrote:
Now that we have multiple branches of docs (1.7.x, 2.0.x, trunk) not to mention the individual versions of the docs versions, I see that this can cause difficulties finding the right information when searching (through Google or otherwise). Today I did a search for "REST API GeoServer" and the top link was for Confluence (natch), but the second link was for 1.7.x. The "stable" branch (2.0.x) was not on the list.
With this in mind, I propose to add new docs URL aliases (leaving the current links as is, for when we need to link to some specific branch):
http://docs.geoserver.org/stable
(for the current stable branch, now 2.0.x)
http://docs.geoserver.org/unstable
(for trunk)
That way, we can start to sync up our doc links, so we can improve searches, help people get to the latest and greatest information, and hopefully start to bury the docs in Confluence once and for all!
Thoughts?
Thanks,
Mike Pumphrey
OpenGeo - http://opengeo.org
------------------------------------------------------------------------------
Throughout its 18-year history, RSA Conference consistently attracts the
world's best and brightest in the field, creating opportunities for Conference
attendees to learn about information security's most important issues through
interactions with peers, luminaries and emerging and established companies.
http://p.sf.net/sfu/rsaconf-dev2dev
_______________________________________________
Geoserver-devel mailing list
Geoserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel