Permalink
Browse files

Whitespace cleanup with "sake strip" (from dm-dev sake tasks)

  • Loading branch information...
1 parent d04f6ba commit 0ff796fa8fe64e1125c74bfd1be405f338fdab9d Dan Kubb committed May 25, 2008
View
@@ -11,4 +11,4 @@ Including:
== Aggregates
-Currently includes count, min, max, avg, sum (more info in dm-aggregates/README)
+Currently includes count, min, max, avg, sum (more info in dm-aggregates/README)
@@ -1,18 +1,18 @@
dm-is-nested_set
================
-DataMapper plugin allowing the creation of nested sets from data models.
+DataMapper plugin allowing the creation of nested sets from data models.
Provides all the same functionality as dm-is-tree, plus tons more! Read on.
== What is a nested set?
-Nested set is a clever model for storing hierarchical data in a flat table.
+Nested set is a clever model for storing hierarchical data in a flat table.
Instead of (only) storing the id of the parent on each node, a nested set puts
all nodes in a clever structure (see Example below). That is what makes it
-possible to get the all of the descendants (not only immediate children),
+possible to get the all of the descendants (not only immediate children),
ancestors, or siblings, in one single query to the database.
-The only downside to nested sets (compared to trees] is that the queries it
+The only downside to nested sets (compared to trees] is that the queries it
takes to know these things, and to move nodes around in the tree are rather
complex. That is what this plugin takes care of (+ lots of other neat stuff)!
@@ -50,10 +50,10 @@ We have a nested menu of categories. The categories are as follows:
- CD Players
In a nested set, each of these categories would have 'left' and 'right' fields,
-informing about where in the set they are positioned. This can be illustrated:
+informing about where in the set they are positioned. This can be illustrated:
_____________________________________________________________________________
| _________________________________ __________________________________ |
-| | ______ _____ ________ | | _______________ _________ | |
+| | ______ _____ ________ | | _______________ _________ | |
| | | | | | | | | | | | | | | |
1 2 3 4 5 6 7 8 9 10 11 12 13 CD- 14 15 16
| | | Tube | | LCD | | Plasma | | | | MP3 Players | | Players | | |
@@ -76,7 +76,7 @@ and left/right values would now be:
_____________________________________________________________________________
| __________________________________ |
| _________________________________ | _______________ | |
-| | ______ _____ ________ | | | _________ | _________ | |
+| | ______ _____ ________ | | | _________ | _________ | |
| | | | | | | | | | | | | | | | | |
1 2 3 4 5 6 7 8 9 10 11 12 Flash 13 14 15 CD- 16 17 18
| | | Tube | | LCD | | Plasma | | | | |_________| | | Players | | |
@@ -93,5 +93,3 @@ and left/right values would now be:
* http://www.developersdex.com/gurus/articles/112.asp
* http://dev.mysql.com/tech-resources/articles/hierarchical-data.html
* http://www.codeproject.com/KB/database/nestedsets.aspx (nice illustrations)
-
-
@@ -6,4 +6,4 @@ TODO
* Add function for (re)building nested set from ordinary tree
* Caching the finder-methods
* Allow options to pass through finders
-* Handle children of destroyed objects
+* Handle children of destroyed objects
Oops, something went wrong. Retry.

0 comments on commit 0ff796f

Please sign in to comment.