[OSM-dev] Augmented Diffs

[Serge Wroclawski]

On Mon, Aug 27, 2012 at 2:14 PM, Roland Olbricht <roland.olbricht at gmx.de> wrote:

> The details are documented in the wiki
>
> http://wiki.openstreetmap.org/wiki/Overpass_API/Augmented_Diffs

The docs you list are a bit confusing, so I went to the XML itself,
and that has some issues, mainly name/document related.

1. The "osm" tag name is already used for a format, so I suggest not using it.

Similarly "osmChange" or "osc" files are already maybe you should call
this something else?

2. The sections are a bit confusing in that the order is very
important. That makes parsing a bit more difficult than it might need
to be if you just renamed sections? Eg "keep" means two different
things in two different contexts, but by using the same name, it means
your parser must keep a lot of state.

If you renamed the xml node names based on what they were for (rather
than just the action), this problem goes away.

- Serge