Skip to content

Commit

Permalink
docs: small update
Browse files Browse the repository at this point in the history
  • Loading branch information
ergo committed Nov 23, 2016
1 parent 16edba5 commit f0a9311
Showing 1 changed file with 8 additions and 1 deletion.
9 changes: 8 additions & 1 deletion docs/usage_examples.rst
Original file line number Diff line number Diff line change
Expand Up @@ -130,6 +130,13 @@ Here is an example of how to connect a user to an external identity like twitter
Tree Structures
---------------

.. warning::

When using `populate_instance` or any other means to set values on resources
remember to **NOT** modify `ordering` and `parent_id` values on the resource
rows - always perform tree operations via tree service. Otherwise it will
confuse the service and it might perform incorrect operations.

Create a tree structure manager:


Expand Down Expand Up @@ -185,4 +192,4 @@ Move node to some other location in tree:
tree_service.move_to_position(
resource_id=resource.resource_id, new_parent_id=X,
to_position=Y, db_session=request.dbsession)
to_position=Y, db_session=request.dbsession)

0 comments on commit f0a9311

Please sign in to comment.