Skip to content

Documentation Process for next release step 2

cvvergara edited this page Oct 17, 2013 · 17 revisions

English documentation for the next release

src/<section>/doc/index.rst

The following is a guideline of the structure for the index.rst files. Things marked between brackets are to be changed acordingly

..
****************************************************************************
pgRouting Manual
Copyright(c) pgRouting Contributors

This documentation is licensed under a Creative Commons Attribution-Share
Alike 3.0 License: http://creativecommons.org/licenses/by-sa/3.0/
****************************************************************************

.. _\<section\>_functions:

\<section\> Functions
===============================================================================

\[General description of the section, may include:\]
\[short overview or description of the algorithm\]
\[A brief description of what are the feature and benefits of this algorithm.\]
[Why I might want to use it over one of the other ones.]
[High level of how the algorithm works]
[what are the inputs (high-level concepts)]
[what can be expected as results.(high-level concepts)]

-  :ref:`pgr_point_to_edgenode` - convert a point geometry to a ``vertex_id`` based on closest edge.
-  :ref:`pgr_flip_edges` - flip the edges in an array of geometries so the connect end to end.
-  :ref:`pgr_text_to_points` - convert a string of ``x,y;x,y;...`` locations into point geometries.
-  :ref:`pgr_points_to_vids` - convert an array of point geometries into vertex ids.

.. toctree:: :hidden:

pgr_pointToEdgeNode - convert a point geometry to a vertex_id based on closest edge. <point_to_edgenode> pgr_flipEdges - flip the edges in an array of geometries so the connect end to end. <flip_edges> pgr_textToPoints - convert a string of x,y;x,y;... locations into point geometries. <text_to_points>

New function's Documentation files.

  • A Developer will create documentation of a "new function"

  • A Developer will modify documentation of a "modified function" maybe because of changes in the functionality

  • User's and translators findings of typos and grammar are posted on [Issue 200] (https://github.com/pgRouting/pgrouting/issues/200)

  • An English reviewer will modify documentation for typos or grammar findings.

Steps Details

Links

Clone this wiki locally