Re: [Geoserver-devel] Documentation cleanup/updates
Hi Mike, Here are some small things from the Jira for making you warm up: http://jira.codehaus.org/browse/GEOS-5509 Page that refers to non-existing tutorial. http://jira.codehaus.org/browse/GEOS-6431 http://jira.codehaus.org/browse/GEOS-6280 http://jira.codehaus.org/browse/GEOS-5708 http://jira.codehaus.org/browse/GEOS-6277 (new icons added later for points, lines, and polygons) A harder one about security: http://jira.codehaus.org/browse/GEOS-5928 http://jira.codehaus.org/browse/GEOS-5912 I am not sure how well http://docs.geoserver.org/stable/en/user/webadmin/security/auth.html and http://docs.geoserver.org/latest/en/user/security/index.html correspond. -Jukka Rahkonen- Mike Pumphrey wrote: Hi all. Apologies for being away for a while. I have recently been given a bit more time/space to contribute to GeoServer, and so my first thought (unsurprisingly) was to see how the docs are doing. So I just wanted to solicit a few opinions here on the -devel list to start for those who have been closer to the project than I have been: * What are the major needs of the documentation as it exists now? * What are the major gaps in the documentation (stuff not in there that should be)? * Is it worth asking those two questions on the -users list as well? I can't guarantee that I'll be able to spend oodles time on this right now, but I can say that I can spend more time than I have been (which, granted, isn't all that hard). Cheers! Thanks, Mike Mike Pumphrey User Advocate | Boundless m...@boundlessgeo.com 917-460-7213 http://boundlessgeo.com @boundlessgeo -- Dive into the World of Parallel Programming! The Go Parallel Website, sponsored by Intel and developed in partnership with Slashdot Media, is your hub for all things parallel software development, from weekly thought leadership blogs to news, videos, case studies, tutorials and more. Take a look and join the conversation now. http://goparallel.sourceforge.net ___ Geoserver-devel mailing list Geoserver-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geoserver-devel -- Dive into the World of Parallel Programming. The Go Parallel Website, sponsored by Intel and developed in partnership with Slashdot Media, is your hub for all things parallel software development, from weekly thought leadership blogs to news, videos, case studies, tutorials and more. Take a look and join the conversation now. http://goparallel.sourceforge.net/ ___ Geoserver-devel mailing list Geoserver-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geoserver-devel
Re: [Geoserver-devel] Documentation cleanup/updates
Welcome back Mike. As a priority I would focus on new functionality coming into GeoServer for the 2.7 release. We will will link to these docs during release announcements to describe new features, and it is a great chance to grab documentation while the developers still know how things are supposed to work. We are also starting to collect a large number of tutorials scattered throughout the user guide. It may be worth gathering these into a logical progression. The REST API continues to be the largest source of confusion on the user list - no specific documentation recommendations here just a not for prioritization. -- Jody -- New Year. New Location. New Benefits. New Data Center in Ashburn, VA. GigeNET is offering a free month of service with a new server in Ashburn. Choose from 2 high performing configs, both with 100TB of bandwidth. Higher redundancy.Lower latency.Increased capacity.Completely compliant. http://p.sf.net/sfu/gigenet___ Geoserver-devel mailing list Geoserver-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geoserver-devel
Re: [Geoserver-devel] Documentation cleanup/updates
Hi Mike, Possibly beyond the scope of your request, but an improved search engine for the docs wouldn't go amiss. After all, what's the use of excellent docs (and generally GeoServer's are some of the best I've seen in an Open Source project) if they're hard/impossible to search effectively. Currently to effectively search it's necessary to use a 3rd-party search engine. Random example I just picked - Try searching using the GeoServer engine for say WMS or when that fails - WMS Animator, which will also fail. Finally try Animator - this time there are 5 results, but none is what should be the obvious result - the WMS Animator page - http://docs.geoserver.org/stable/en/user/tutorials/animreflector.html. Cheers, Jonathan -Original Message- From: Mike Pumphrey [mailto:m...@boundlessgeo.com] Sent: Friday, January 09, 2015 10:44 PM To: Geoserver-devel Subject: [Geoserver-devel] Documentation cleanup/updates Hi all. Apologies for being away for a while. I have recently been given a bit more time/space to contribute to GeoServer, and so my first thought (unsurprisingly) was to see how the docs are doing. So I just wanted to solicit a few opinions here on the -devel list to start for those who have been closer to the project than I have been: * What are the major needs of the documentation as it exists now? * What are the major gaps in the documentation (stuff not in there that should be)? * Is it worth asking those two questions on the -users list as well? I can't guarantee that I'll be able to spend oodles time on this right now, but I can say that I can spend more time than I have been (which, granted, isn't all that hard). Cheers! Thanks, Mike Mike Pumphrey User Advocate | Boundless m...@boundlessgeo.com 917-460-7213 http://boundlessgeo.com @boundlessgeo -- Dive into the World of Parallel Programming! The Go Parallel Website, sponsored by Intel and developed in partnership with Slashdot Media, is your hub for all things parallel software development, from weekly thought leadership blogs to news, videos, case studies, tutorials and more. Take a look and join the conversation now. http://goparallel.sourceforge.net ___ Geoserver-devel mailing list Geoserver-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geoserver-devel This message has been scanned for viruses by MailControl - www.mailcontrol.com Click https://www.mailcontrol.com/sr/jECmNiDIR1bGX2PQPOmvUhStAXlT3N1zw2nExCL7lc4mesK!cV1dCrQGI020uRyhgT3984G7pp!BcfXS4znW5Q== to report this email as spam. HR Wallingford and its subsidiaries uses faxes and emails for confidential and legally privileged business communications. They do not of themselves create legal commitments. Disclosure to parties other than addressees requires our specific consent. We are not liable for unauthorised disclosures nor reliance upon them. If you have received this message in error please advise us immediately and destroy all copies of it. HR Wallingford Limited Howbery Park, Wallingford, Oxfordshire, OX10 8BA, United Kingdom Registered in England No. 02562099 -- New Year. New Location. New Benefits. New Data Center in Ashburn, VA. GigeNET is offering a free month of service with a new server in Ashburn. Choose from 2 high performing configs, both with 100TB of bandwidth. Higher redundancy.Lower latency.Increased capacity.Completely compliant. vanity: www.gigenet.com ___ Geoserver-devel mailing list Geoserver-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geoserver-devel
Re: [Geoserver-devel] Documentation cleanup/updates
On Fri, Jan 9, 2015 at 11:43 PM, Mike Pumphrey m...@boundlessgeo.com wrote: Hi all. Apologies for being away for a while. I have recently been given a bit more time/space to contribute to GeoServer, and so my first thought (unsurprisingly) was to see how the docs are doing. Welcome back :) So I just wanted to solicit a few opinions here on the -devel list to start for those who have been closer to the project than I have been: * What are the major needs of the documentation as it exists now? * What are the major gaps in the documentation (stuff not in there that should be)? Hum... answering both questions, maybe more tutorials around full solutions? Like, our current guide is in many ways a reference, people searching for howto style docs are often left out. * Is it worth asking those two questions on the -users list as well? Indeed I think it would be a good idea, after all, they are the primary users (pun not intended) of the docs Cheers Andrea -- == GeoServer Professional Services from the experts! Visit http://goo.gl/NWWaa2 for more information. == Ing. Andrea Aime @geowolf Technical Lead GeoSolutions S.A.S. Via Poggio alle Viti 1187 55054 Massarosa (LU) Italy phone: +39 0584 962313 fax: +39 0584 1660272 mob: +39 339 8844549 http://www.geo-solutions.it http://twitter.com/geosolutions_it *AVVERTENZE AI SENSI DEL D.Lgs. 196/2003* Le informazioni contenute in questo messaggio di posta elettronica e/o nel/i file/s allegato/i sono da considerarsi strettamente riservate. Il loro utilizzo è consentito esclusivamente al destinatario del messaggio, per le finalità indicate nel messaggio stesso. Qualora riceviate questo messaggio senza esserne il destinatario, Vi preghiamo cortesemente di darcene notizia via e-mail e di procedere alla distruzione del messaggio stesso, cancellandolo dal Vostro sistema. Conservare il messaggio stesso, divulgarlo anche in parte, distribuirlo ad altri soggetti, copiarlo, od utilizzarlo per finalità diverse, costituisce comportamento contrario ai principi dettati dal D.Lgs. 196/2003. The information in this message and/or attachments, is intended solely for the attention and use of the named addressee(s) and may be confidential or proprietary in nature or covered by the provisions of privacy act (Legislative Decree June, 30 2003, no.196 - Italy's New Data Protection Code).Any use not in accord with its purpose, any disclosure, reproduction, copying, distribution, or either dissemination, either whole or partial, is strictly forbidden except previous formal approval of the named addressee(s). If you are not the intended recipient, please contact immediately the sender by telephone, fax or e-mail and delete the information in this message that has been received in error. The sender does not give any warranty or accept liability as the content, accuracy or completeness of sent messages and accepts no responsibility for changes made after they were sent or for other risks which arise as a result of e-mail transmission, viruses, etc. --- -- New Year. New Location. New Benefits. New Data Center in Ashburn, VA. GigeNET is offering a free month of service with a new server in Ashburn. Choose from 2 high performing configs, both with 100TB of bandwidth. Higher redundancy.Lower latency.Increased capacity.Completely compliant. www.gigenet.com___ Geoserver-devel mailing list Geoserver-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geoserver-devel
Re: [Geoserver-devel] Documentation cleanup/updates
I was able to add several pre-canned searches to this page: http://geoserver.org/comm/ Perhaps we could do a similar thing for docs.geoserver.org -- Jody Garnett On 12 January 2015 at 04:40, Jonathan Moules j.mou...@hrwallingford.com wrote: Hi Mike, Possibly beyond the scope of your request, but an improved search engine for the docs wouldn't go amiss. After all, what's the use of excellent docs (and generally GeoServer's are some of the best I've seen in an Open Source project) if they're hard/impossible to search effectively. Currently to effectively search it's necessary to use a 3rd-party search engine. Random example I just picked - Try searching using the GeoServer engine for say WMS or when that fails - WMS Animator, which will also fail. Finally try Animator - this time there are 5 results, but none is what should be the obvious result - the WMS Animator page - http://docs.geoserver.org/stable/en/user/tutorials/animreflector.html. Cheers, Jonathan -Original Message- From: Mike Pumphrey [mailto:m...@boundlessgeo.com] Sent: Friday, January 09, 2015 10:44 PM To: Geoserver-devel Subject: [Geoserver-devel] Documentation cleanup/updates Hi all. Apologies for being away for a while. I have recently been given a bit more time/space to contribute to GeoServer, and so my first thought (unsurprisingly) was to see how the docs are doing. So I just wanted to solicit a few opinions here on the -devel list to start for those who have been closer to the project than I have been: * What are the major needs of the documentation as it exists now? * What are the major gaps in the documentation (stuff not in there that should be)? * Is it worth asking those two questions on the -users list as well? I can't guarantee that I'll be able to spend oodles time on this right now, but I can say that I can spend more time than I have been (which, granted, isn't all that hard). Cheers! Thanks, Mike Mike Pumphrey User Advocate | Boundless m...@boundlessgeo.com 917-460-7213 http://boundlessgeo.com @boundlessgeo -- Dive into the World of Parallel Programming! The Go Parallel Website, sponsored by Intel and developed in partnership with Slashdot Media, is your hub for all things parallel software development, from weekly thought leadership blogs to news, videos, case studies, tutorials and more. Take a look and join the conversation now. http://goparallel.sourceforge.net ___ Geoserver-devel mailing list Geoserver-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geoserver-devel This message has been scanned for viruses by MailControl - www.mailcontrol.com Click https://www.mailcontrol.com/sr/jECmNiDIR1bGX2PQPOmvUhStAXlT3N1zw2nExCL7lc4mesK!cV1dCrQGI020uRyhgT3984G7pp!BcfXS4znW5Q== to report this email as spam. HR Wallingford and its subsidiaries uses faxes and emails for confidential and legally privileged business communications. They do not of themselves create legal commitments. Disclosure to parties other than addressees requires our specific consent. We are not liable for unauthorised disclosures nor reliance upon them. If you have received this message in error please advise us immediately and destroy all copies of it. HR Wallingford Limited Howbery Park, Wallingford, Oxfordshire, OX10 8BA, United Kingdom Registered in England No. 02562099 -- New Year. New Location. New Benefits. New Data Center in Ashburn, VA. GigeNET is offering a free month of service with a new server in Ashburn. Choose from 2 high performing configs, both with 100TB of bandwidth. Higher redundancy.Lower latency.Increased capacity.Completely compliant. vanity: www.gigenet.com ___ Geoserver-devel mailing list Geoserver-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geoserver-devel -- New Year. New Location. New Benefits. New Data Center in Ashburn, VA. GigeNET is offering a free month of service with a new server in Ashburn. Choose from 2 high performing configs, both with 100TB of bandwidth. Higher redundancy.Lower latency.Increased capacity.Completely compliant. www.gigenet.com___ Geoserver-devel mailing list Geoserver-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geoserver-devel
Re: [Geoserver-devel] Documentation cleanup/updates
Hi Jonathan. It's a bit out of my wheelhouse, but it shouldn't be too difficult to have the search box perform a Google Site Search or something similar. I've found the search feature of Sphinx to be odd and lacking in a number of areas. To use your example: https://www.google.com/search?q=animator+site%3Adocs.geoserver.org It's the first result. Thanks, Mike Mike Pumphrey User Advocate | Boundless m...@boundlessgeo.com 917-460-7213 http://boundlessgeo.com @boundlessgeo On 1/12/2015 4:40 AM, Jonathan Moules wrote: Hi Mike, Possibly beyond the scope of your request, but an improved search engine for the docs wouldn't go amiss. After all, what's the use of excellent docs (and generally GeoServer's are some of the best I've seen in an Open Source project) if they're hard/impossible to search effectively. Currently to effectively search it's necessary to use a 3rd-party search engine. Random example I just picked - Try searching using the GeoServer engine for say WMS or when that fails - WMS Animator, which will also fail. Finally try Animator - this time there are 5 results, but none is what should be the obvious result - the WMS Animator page - http://docs.geoserver.org/stable/en/user/tutorials/animreflector.html. Cheers, Jonathan -Original Message- From: Mike Pumphrey [mailto:m...@boundlessgeo.com] Sent: Friday, January 09, 2015 10:44 PM To: Geoserver-devel Subject: [Geoserver-devel] Documentation cleanup/updates Hi all. Apologies for being away for a while. I have recently been given a bit more time/space to contribute to GeoServer, and so my first thought (unsurprisingly) was to see how the docs are doing. So I just wanted to solicit a few opinions here on the -devel list to start for those who have been closer to the project than I have been: * What are the major needs of the documentation as it exists now? * What are the major gaps in the documentation (stuff not in there that should be)? * Is it worth asking those two questions on the -users list as well? I can't guarantee that I'll be able to spend oodles time on this right now, but I can say that I can spend more time than I have been (which, granted, isn't all that hard). Cheers! Thanks, Mike Mike Pumphrey User Advocate | Boundless m...@boundlessgeo.com 917-460-7213 http://boundlessgeo.com @boundlessgeo -- Dive into the World of Parallel Programming! The Go Parallel Website, sponsored by Intel and developed in partnership with Slashdot Media, is your hub for all things parallel software development, from weekly thought leadership blogs to news, videos, case studies, tutorials and more. Take a look and join the conversation now. http://goparallel.sourceforge.net ___ Geoserver-devel mailing list Geoserver-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geoserver-devel This message has been scanned for viruses by MailControl - www.mailcontrol.com Click https://www.mailcontrol.com/sr/jECmNiDIR1bGX2PQPOmvUhStAXlT3N1zw2nExCL7lc4mesK!cV1dCrQGI020uRyhgT3984G7pp!BcfXS4znW5Q== to report this email as spam. HR Wallingford and its subsidiaries uses faxes and emails for confidential and legally privileged business communications. They do not of themselves create legal commitments. Disclosure to parties other than addressees requires our specific consent. We are not liable for unauthorised disclosures nor reliance upon them. If you have received this message in error please advise us immediately and destroy all copies of it. HR Wallingford Limited Howbery Park, Wallingford, Oxfordshire, OX10 8BA, United Kingdom Registered in England No. 02562099 -- New Year. New Location. New Benefits. New Data Center in Ashburn, VA. GigeNET is offering a free month of service with a new server in Ashburn. Choose from 2 high performing configs, both with 100TB of bandwidth. Higher redundancy.Lower latency.Increased capacity.Completely compliant. www.gigenet.com ___ Geoserver-devel mailing list Geoserver-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geoserver-devel
