Whoops, that's right, you did say that. Okay, I took those examples, did some copyediting on them and fixed the Sphinx errors, and added them to the pull request. If it looks good to you, I'll commit on 2.2.x, master, and the newly-created 2.3.x.
Thanks, Mike Pumphrey OpenGeo - http://opengeo.org On 1/30/2013 3:26 AM, carlo cancellieri wrote: > Mike, > Ok looks good, but still missing the curl examples, don't know if you want > to include them; if so, take a look here: > /en/user/source/restconfig/rest-config-examples/rest-config-examples-curl.rst > https://github.com/ccancellieri/geoserver/commit/d437d1544d389030d2c375b47a837cc71095ef4d > > Thank you, > Carlo > > 2013/1/29 Mike Pumphrey <[email protected]> > >> Great, I think I have all my questions answered now. Please see >> https://github.com/geoserver/**geoserver/pull/126<https://github.com/geoserver/geoserver/pull/126>. >> If no changes are necessary, please accept and port to master as well (or I >> can do that). Thanks! >> >> >> >> Thanks, >> Mike Pumphrey >> OpenGeo - http://opengeo.org >> >> >> On 1/29/2013 2:26 AM, carlo cancellieri wrote: >> >>> Hi Mike, >>> >>> see inline. >>> >>> I have a few additional questions, but they may be answered when I >>> actually >>> >>>> try out the software, but I can't seem to find where it is. Some >>>> questions >>>> that come to mind: >>>> >>>> * When entering rest/about/manifest.xml?..., what happens when the key >>>> value pair is omitted? The docs don't say. >>>> >>>> >>> The default format is [.html] so when you point to rest/about/manifest you >>> get the same result as per rest/about/manifest.html. You'll get a list of >>> all the manifest files (with properties) of all the jars loaded by the >>> classloader. >>> >>> >>> * Where is the manifest.properties file placed? >>>> >>>> >>> It is located into the main jar of the geoserver core. If you want to >>> change (override) default settings you have to place a copy of that file >>> (with your changes) into the GeoServer Data dir (root). >>> >>> >>> * There are two different endpoints in this section, about/manifest, and >>>> about/version. How are they related? What would I call both of them >>>> together? "About" seems a bit non-specific. >>>> >>>> >>> When you ask to geoserver (via web gui) for the about page you simply get >>> the versions of the main used components. >>> Something like: >>> ------------------------------**----------------------------- >>> >>> - Version2.2-SNAPSHOT >>> - Git Revision8d37359c56b8cb07d560d6**00fe1cd76db7236619 >>> - Build Date25-Jan-2013 02:50 >>> - GeoTools Version8-SNAPSHOT (rev >>> d64d6a20e83ed60dc6e5ffea564a0c**38e88ed4d2) >>> - ------------------------------**----------------------------- >>> >>> >>> This is more or less the same of what you get using about/version. >>> The about/manifest[.format] instead is a more detailed list of version >>> (with all the loaded libraries) which can be used for reports or to check >>> configuration programmatically (for example in Continuous Integration). >>> I added the filter capabilities to be able to filter by core, extensions, >>> communities and customized jars (in the way I show you in the examples). >>> >>> >>> It might seem a little slow and laborious, but I've found that this kind >>>> of back-and-forth really helps to make clear, quality documentation. (I'm >>>> documentation lead at OpenGeo.) If you have any questions, please let me >>>> know. I appreciate your help! >>>> >>> >>> >>> I know, documentation really important for software, so no problem Mike, >>> nice to meet you :) >>> >>> >>> Also, what version does this about/manifest functionality work against? >>>> >>>>> I've got 2.2.4 installed, and I don't seem to have that endpoint at all. >>>>> Commands like this: >>>>> http://localhost:8080/****geoserver/rest/about/manifest.****<http://localhost:8080/**geoserver/rest/about/manifest.**> >>>>> xml?key=GeoServerModule&value=****extension<http://localhost:** >>>>> 8080/geoserver/rest/about/**manifest.xml?key=**GeoServerModule&value=** >>>>> extension<http://localhost:8080/geoserver/rest/about/manifest.xml?key=GeoServerModule&value=extension> >>>>> > >>>>> >>>>> don't respond with anything other than the generic rest interface. Is >>>>> this a 2.3.x feature or did this happen after 2.2.4? >>>>> >>>>> >>>> It will be available since 2.2.5 and 2.3.0 >>> >>> Thank you, >>> Carlo >>> >>> >>> >>> >>>> There's a good chance I just don't follow what's going on. But as long >>>>> as >>>>> I was (re-)adding documentation, I figured I'd test it out. Thanks. >>>>> >>>>> >>>>> Thanks, >>>>> Mike Pumphrey >>>>> OpenGeo - http://opengeo.org >>>>> >>>>> >>>>> On 1/25/2013 1:34 AM, carlo cancellieri wrote: >>>>> >>>>> Mike, >>>>>> >>>>>> I'm not excellent at figuring out diffs manually, but looking at that >>>>>> >>>>>> commit, I see that the primary difference is the "About" section. Did >>>>>>> I >>>>>>> miss something else? Please let me know, and I'll copy the section(s) >>>>>>> back >>>>>>> in. >>>>>>> >>>>>>> >>>>>> >>>>>> We are lucky, I used a different commit only for docs. >>>>>> >>>>>> Looking at the diffs you'll note a new set of files here: >>>>>> doc/en/user/source/restconfig/****representations/*.txt >>>>>> >>>>>> >>>>>> And some additions (regarding 'about') to the file: >>>>>> doc/en/user/source/restconfig/****rest-config-api.rst >>>>>> >>>>>> >>>>>> That's it. >>>>>> Cheers, >>>>>> Carlo >>>>>> >>>>>> >>>>>> >>>>>> >>>>>> >>>>>> >>>>>>> Thanks, >>>>>>> Mike Pumphrey >>>>>>> OpenGeo - http://opengeo.org >>>>>>> >>>>>>> >>>>>>> On 1/24/2013 6:49 AM, carlo cancellieri wrote: >>>>>>> >>>>>>> Hi Mike, >>>>>>> >>>>>>>> I think we have missed (cutted off) some pieces of documentation >>>>>>>> during >>>>>>>> this "Improved / corrected REST documentation (see GEOS-5595)" >>>>>>>> refactoring >>>>>>>> (regarding the about/version about/manifest improvements): >>>>>>>> please take a look to: >>>>>>>> on branch 2.2.x - the commit "******619156c0e2a0946b58ea0e3877dfda** >>>>>>>> **** >>>>>>>> 806417300d" >>>>>>>> "adding documentation" >>>>>>>> on branch master - the commit '******54eebfb03058538e34c47e05f08f24* >>>>>>>> ***** >>>>>>>> >>>>>>>> 50d76a347e' >>>>>>>> "adding documentation" >>>>>>>> >>>>>>>> To marge missing part of the documentation. >>>>>>>> Cheers, >>>>>>>> Carlo >>>>>>>> >>>>>>>> >>>>>>>> >>>>>>>> 2013/1/23 Justin Deoliveira <[email protected]> >>>>>>>> >>>>>>>> I think you should be fine here Mike. I think jody is going to be >>>>>>>> trying >>>>>>>> >>>>>>>> a >>>>>>>>> 2.3 release again tonight but this shouldn't conflict. >>>>>>>>> >>>>>>>>> >>>>>>>>> On Tue, Jan 22, 2013 at 11:44 AM, Mike Pumphrey <[email protected]> >>>>>>>>> wrote: >>>>>>>>> >>>>>>>>> This pull request updates /corrects the REST API documentation. I >>>>>>>>> know >>>>>>>>> >>>>>>>>> that we are in the middle of a release process, so I just wanted to >>>>>>>>>> ask >>>>>>>>>> (specifically Andrea) if it's okay if I go ahead and merge it in, >>>>>>>>>> or >>>>>>>>>> whether I should wait. >>>>>>>>>> >>>>>>>>>> https://github.com/geoserver/********geoserver/pull/111<https://github.com/geoserver/******geoserver/pull/111> >>>>>>>>>> <https:**//github.com/geoserver/******geoserver/pull/111<https://github.com/geoserver/****geoserver/pull/111> >>>>>>>>>> > >>>>>>>>>> <https://**github.com/**geoserver/****geoserver/pull/**111<http://github.com/geoserver/****geoserver/pull/111> >>>>>>>>>> <https://github.com/**geoserver/**geoserver/pull/111<https://github.com/geoserver/**geoserver/pull/111> >>>>>>>>>> **> >>>>>>>>>> > >>>>>>>>>> <https://**github.com/****geoserver/**geoserver/pull/111<http://github.com/**geoserver/**geoserver/pull/111> >>>>>>>>>> **<http://github.com/geoserver/****geoserver/pull/111<http://github.com/geoserver/**geoserver/pull/111> >>>>>>>>>> > >>>>>>>>>> **<https://github.com/**geoserver/**geoserver/pull/111<https://github.com/geoserver/**geoserver/pull/111> >>>>>>>>>> **<https://github.com/geoserver/**geoserver/pull/111<https://github.com/geoserver/geoserver/pull/111> >>>>>>>>>> > >>>>>>>>>> >>>>>>>>>> > >>>>>>>>>> > >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> Thanks, >>>>>>>>>> Mike Pumphrey >>>>>>>>>> OpenGeo - http://opengeo.org >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> -- >>>>>>>>> Justin Deoliveira >>>>>>>>> OpenGeo - http://opengeo.org >>>>>>>>> Enterprise support for open source geospatial. >>>>>>>>> >>>>>>>>> >>>>>>>>> ------------------------------******--------------------------** >>>>>>>>> --**--** >>>>>>>>> >>>>>>>>> ------------------ >>>>>>>>> Master Visual Studio, SharePoint, SQL, ASP.NET, C# 2012, HTML5, >>>>>>>>> CSS, >>>>>>>>> MVC, Windows 8 Apps, JavaScript and much more. Keep your skills >>>>>>>>> current >>>>>>>>> with LearnDevNow - 3,200 step-by-step video tutorials by Microsoft >>>>>>>>> MVPs and experts. ON SALE this month only -- learn more at: >>>>>>>>> http://p.sf.net/sfu/learnnow-******d2d<http://p.sf.net/sfu/learnnow-****d2d> >>>>>>>>> <http://p.sf.net/sfu/**learnnow-**d2d<http://p.sf.net/sfu/learnnow-**d2d> >>>>>>>>> >< >>>>>>>>> http://p.sf.net/sfu/learnnow-****d2d<http://p.sf.net/sfu/learnnow-**d2d>< >>>>>>>>> http://p.sf.net/sfu/learnnow-**d2d<http://p.sf.net/sfu/learnnow-d2d> >>>>>>>>> > >>>>>>>>> > >>>>>>>>> ______________________________******_________________ >>>>>>>>> Geoserver-devel mailing list >>>>>>>>> Geoserver-devel@lists.****source**forge.net <http://sourceforge.net >>>>>>>>> >< >>>>>>>>> Geoserver-devel@**lists.**sourceforge.net<http://lists.sourceforge.net> >>>>>>>>> <Geoserver-**[email protected]<[email protected]> >>>>>>>>> > >>>>>>>>> > >>>>>>>>> https://lists.sourceforge.net/******lists/listinfo/geoserver-*** >>>>>>>>> *devel<https://lists.sourceforge.net/****lists/listinfo/geoserver-**devel> >>>>>>>>> <https://lists.**sourceforge.net/**lists/**listinfo/geoserver-devel<https://lists.sourceforge.net/**lists/listinfo/geoserver-devel> >>>>>>>>> > >>>>>>>>> <https://lists.**sourceforge.**net/lists/**listinfo/** >>>>>>>>> geoserver-devel<http://sourceforge.net/lists/**listinfo/geoserver-devel> >>>>>>>>> <https://lists.**sourceforge.net/lists/**listinfo/geoserver-devel<https://lists.sourceforge.net/lists/listinfo/geoserver-devel> >>>>>>>>> > >>>>>>>>> > >>>>>>>>> >>>>>>>>> >>>>>>>>> >>>>>>>>> >>>>>>>>> >>>>>>>> >>>>>>>> >>>>>> >>>>>> >>>>> >>> >>> > > ------------------------------------------------------------------------------ Everyone hates slow websites. So do we. Make your web apps faster with AppDynamics Download AppDynamics Lite for free today: http://p.sf.net/sfu/appdyn_d2d_jan _______________________________________________ Geoserver-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/geoserver-devel
