shortbread-docs
shortbread-docs copied to clipboard
Documentation of the Shortbread vector tile schema
Several tables have the name, name_en, and name_de properties defined. This works for now, but as #22 is solved and names gain in complexity, we should move the explanation on...
There should be a roadmap for plans for the schema. I suggest the following as a start 1. Continue to work on the definition of layers to make it clearer...
The docs say way_area and admin_level are numeric. Vector tiles don't have such a type - they have float, double, int, uint, and sint.
The `water_polygons` layer contains a number of features with definitions that can overlap because they're coming from different OSM keys. As an example, something with `landuse=river natural=water` would meet the...
Some aqueducts are mapped as water polygons when they are broad enough, just like this one: https://www.openstreetmap.org/way/199901926#map=19/43.57398/1.46914 For this to render correctly, it would be necessary to add optionally at...
Barriers are currently omitted from the shortbread schema. At least point barriers such as bollards or gates are important to see on maps which roads are accessible. There should probably...
I believe there is an almost endless range of POIs that _could_ be included in the POI layer. If the shortbread schema is going to be used more, I predict...
Different implementations may prefer different ways of turning polygons into points, and this lets them experiment with new ways. Additionally, the centroid is a particularly bad algorithm as it may...
We should have a versioning policy that sets out expectations for what can change between revisions. I made this draft as a starting place for discussion.
I've added two parts of the presentation: * Creating Shortbread Vector Tiles (more tools, tutorials, etc.) * Customizing Shortbread (raw slides, full text missing) For the second part I'm not...