Opened 2 years ago

Last modified 11 months ago

#5109 new enhancement

Topology documentation uses unexplained concepts

Reported by: asgerpetersen Owned by: strk
Priority: medium Milestone: PostGIS 3.5.0
Component: documentation Version: 3.2.x
Keywords: Cc:

Description

next_left_edge is mentioned a the docs for AddFace and Polygonize in the topology documentation. For instance in https://postgis.net/docs/TopologyPolygonize.html it says "Note: This function does not use nor set the next_left_edge and next_right_edge fields of the edge table."

However there is no documentation of what 'next_left_edge' means and what it does. The user is left without any way of figuring out what the consequences of that note are.

Change History (4)

comment:1 by strk, 2 years ago

We probably want to add a chapter about the "topology schema". Closest to an explanation is the slide deck http://strk.kbt.io/projects/postgis/Paris2011_TopologyWithPostGIS_2_0.pdf which is linked from https://postgis.net/docs/Topology.html

If you want to help improving the manual you can send a pull request with edits to this file: https://git.osgeo.org/gitea/postgis/postgis/src/branch/master/doc/extras_topology.xml

comment:2 by robe, 21 months ago

Milestone: PostGIS 3.3.0PostGIS 3.4.0

comment:3 by robe, 11 months ago

Owner: changed from robe to strk

comment:4 by robe, 11 months ago

Milestone: PostGIS 3.4.0PostGIS 3.5.0
Note: See TracTickets for help on using tickets.