try to document use_nodecache.py

[matkoniecz]

note that I am pretty sure it is correct but not fully sure

And I do not understand yet how can I use nodecache for areas and is it even doable/useful with multipolygons

I am also lacking clarity whether way should be understand as "OSM way object" or "linear way which excludes OSM closed ways representing areas".

Will try to experiment and also add this info in future.

[lonvia]

I am also lacking clarity whether way should be understand as "OSM way object" or "linear way which excludes OSM closed ways representing areas".

OSM ways. When you add an area handler, then closed ways will be presented twice, once in the way handler as a linear feature and again in the area handler as a polygon. There is no guarantee as to which comes first. Consulte the libosmium manual for details.

As said before, better documentation is in progress.

[matkoniecz]

As said before, better documentation is in progress.

And I will definitely use it when it will appear! Though for now I (mostly) manage to use what is now, so unless it will appear really soon it seems that waiting is not needed.

Unless it refers to that it is pointless to submit improvements now as new version will replace and obliterate all existing content anyway?

[lonvia]

Unless it refers to that it is pointless to submit improvements now as new version will replace and obliterate all existing content anyway?

There is a high probability that this will happen for any documentation changes. I haven't made up my mind yet, what will happen to the examples.