Ben Caradoc-Davies ha scritto: > Andrea, > > I have committed the app-schema tutorial to trunk. For your convenience, > I have put the generated HTML on one of our servers: > > https://twiki.auscope.org/projects/geoserver/geoserver-trunk-doc/user/tutorials/app-schema/app-schema-tutorial.html > > Please let me know if there is anything you would like clarified, > simplified, or otherwise improved.
Looked a bit into it. Some general feedback: - the tutorial assumes familarity with SVN, it would be nicer to provide a link to a zipped file with everything needed to setup the tutorial - the tutorial uses property files. Developers are comfortable with them, but I think no normal user has ever seen that data source in action. Some explanation about it is probably required - the structure made me go up and down quite a few times because the title structure is flat, some titles explain parts of a file, some others explain a standalone file. For example "gsml:MappedFeature datastore" talks about a single file, but "Namespaces" talks about the content of a single mapping file. As one that never played with complex features I miss a bit of context: - why are we declaring namespaces in the mapping file (ok, this one I understand, but put yourself in the place of one that never saw complex features) - why do we refer an external catalog... and what is a OASIS catalog to start with? - the target types section refer to http://www.geosciml.org/geosciml/2.0/xsd/geosciml.xsd This leaves me baffled... no reference to a type or element name? A XSD file can define plenty, afaik there is not concept of main, root type. So what is the meaning of <FeatureType> there? It's not like the schema contains the definition of a specific one no? I understand you need to refer the schema that contains the mapped types, but the names are misleading and there is no explanation. - in gml:id mapping, why OCQL? I've heard of ECQL (extended) but never about OCQL Finally, I'm a little concerned about the many referencing to your wiki... as in, how long is that wiki going to be around? Plus, say you work on new features, how do you ensure the GeoServer 2.0 documentation points to the state the wiki had for 2.0, and not the current one? (in other terms, how to ensure the documentation is versioned?) Cheers Andrea -- Andrea Aime OpenGeo - http://opengeo.org Expert service straight from the developers. ------------------------------------------------------------------------------ Crystal Reports - New Free Runtime and 30 Day Trial Check out the new simplified licensing option that enables unlimited royalty-free distribution of the report engine for externally facing server and web deployment. http://p.sf.net/sfu/businessobjects _______________________________________________ Geoserver-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/geoserver-devel
