Do we build and publish the documentation guide? Would it be easier if it were included in the developer guide?
--
Ben Caradoc-Davies <Ben.Caradoc-Davies@anonymised.com>
Software Engineering Team Leader
CSIRO Earth Science and Resource Engineering
Australian Resources Research Centre
On 05/26/2010 03:52 AM, Ben Caradoc-Davies wrote:
Do we build and publish the documentation guide? Would it be easier if
it were included in the developer guide?
To my knowledge the copy that is built nightly and published to http://docs.geoserver.org/trunk/en/docguide/ is the only "published" version of the documentation guide. It's the very last thing on the front page at http://docs.geoserver.org/ ; I imagine we could come up with a less hidden place for it if we thought for a while. I'm not sure a section in the developer docs would be better though. The docs should be editable by moderately technical end users, while the developer docs are (much) more demanding of techie know-how.
Maybe a sidebar on the docs listing would be better?
--
David Winslow
OpenGeo - http://opengeo.org/
On 26/05/10 22:07, David Winslow wrote:
To my knowledge the copy that is built nightly and published to
http://docs.geoserver.org/trunk/en/docguide/ is the only "published"
version of the documentation guide. It's the very last thing on the
front page at http://docs.geoserver.org/ ; I imagine we could come up
with a less hidden place for it if we thought for a while. I'm not sure
a section in the developer docs would be better though. The docs should
be editable by moderately technical end users, while the developer docs
are (much) more demanding of techie know-how.
Maybe a sidebar on the docs listing would be better?
Thanks, I see it now. Perhaps moving it into the trunk section, with the other trunk docs? I think the reason I missed it was that I expected so see it in the trunk section.
--
Ben Caradoc-Davies <Ben.Caradoc-Davies@anonymised.com>
Software Engineering Team Leader
CSIRO Earth Science and Resource Engineering
Australian Resources Research Centre
Thanks, I see it now. Perhaps moving it into the trunk section, with the
other trunk docs? I think the reason I missed it was that I expected so
see it in the trunk section.
http://docs.geoserver.org/trunk/en/docguide/
It is in the trunk section. 
It's just its own project.
Since I've recently relearned how to edit the geoserver.org theme, I could add a link to it on there. But the docguide never seemed to fit in with the User Manual or the Developer Manual, which is why it was never made part of either. I figured throwing it on the shell at docs.geoserver.org was a good start. No harm in moving things around if it's confusing.
Thanks,
Mike Pumphrey
OpenGeo - http://opengeo.org
On 5/26/2010 9:42 PM, Ben Caradoc-Davies wrote:
On 26/05/10 22:07, David Winslow wrote:
To my knowledge the copy that is built nightly and published to
http://docs.geoserver.org/trunk/en/docguide/ is the only "published"
version of the documentation guide. It's the very last thing on the
front page at http://docs.geoserver.org/ ; I imagine we could come up
with a less hidden place for it if we thought for a while. I'm not sure
a section in the developer docs would be better though. The docs should
be editable by moderately technical end users, while the developer docs
are (much) more demanding of techie know-how.
Maybe a sidebar on the docs listing would be better?Thanks, I see it now. Perhaps moving it into the trunk section, with the
other trunk docs? I think the reason I missed it was that I expected so
see it in the trunk section.
On 27/05/10 22:52, Mike Pumphrey wrote:
Thanks, I see it now. Perhaps moving it into the trunk section, with the
other trunk docs? I think the reason I missed it was that I expected so
see it in the trunk section.http://docs.geoserver.org/trunk/en/docguide/
It is in the trunk section.
Sorry, I mean move the link on the docs page from the bottom to the trunk section to be with the other trunk links:
http://docs.geoserver.org/
--
Ben Caradoc-Davies <Ben.Caradoc-Davies@anonymised.com>
Software Engineering Team Leader
CSIRO Earth Science and Resource Engineering
Australian Resources Research Centre
Actually, even though it's not 100% correct, I thought it would be less confusing and more visible to put it with the top links. But it's easy to move around, so please suggest away.
Thanks,
Mike Pumphrey
OpenGeo - http://opengeo.org
On 5/27/2010 10:40 PM, Ben Caradoc-Davies wrote:
On 27/05/10 22:52, Mike Pumphrey wrote:
Thanks, I see it now. Perhaps moving it into the trunk section, with the
other trunk docs? I think the reason I missed it was that I expected so
see it in the trunk section.http://docs.geoserver.org/trunk/en/docguide/
It is in the trunk section.Sorry, I mean move the link on the docs page from the bottom to the
trunk section to be with the other trunk links:
http://docs.geoserver.org/
That looks fine. Thanks, Mike.
On 29/05/10 03:19, Mike Pumphrey wrote:
Actually, even though it's not 100% correct, I thought it would be less confusing and more visible to put it with the top links. But it's easy to move around, so please suggest away.
Thanks,
Mike Pumphrey
OpenGeo - http://opengeo.orgOn 5/27/2010 10:40 PM, Ben Caradoc-Davies wrote:
On 27/05/10 22:52, Mike Pumphrey wrote:
Thanks, I see it now. Perhaps moving it into the trunk section, with the
other trunk docs? I think the reason I missed it was that I expected so
see it in the trunk section.http://docs.geoserver.org/trunk/en/docguide/
It is in the trunk section.Sorry, I mean move the link on the docs page from the bottom to the
trunk section to be with the other trunk links:
http://docs.geoserver.org/------------------------------------------------------------------------------
_______________________________________________
Geoserver-devel mailing list
Geoserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel
--
Ben Caradoc-Davies <Ben.Caradoc-Davies@anonymised.com>
Software Engineering Team Leader
CSIRO Earth Science and Resource Engineering
Australian Resources Research Centre