Documentation updates

halfhp · halfhp · commit a124e850eb31 · 2017-07-12T09:25:48.000-05:00
diff --git a/docs/index.md b/docs/index.md
@@ -15,6 +15,7 @@ specific plot types explaining styling and other advanced topics.
 * [Quickstart](quickstart.md) :star:
 * [Quickstart (YouTube Video)](https://www.youtube.com/watch?v=wEFkzQY_wWI) :movie_camera:
 * [Plot Composition](plot_composition.md)
+* [The Legend](legend.md)
 * [XY Plots](xyplot.md)
 * [Bar Charts](barchart.md)
 * [Candlestick Charts](candlestick.md)
diff --git a/docs/legend.md b/docs/legend.md
@@ -13,7 +13,7 @@ plot.getLegend().setVisible(true|false);
 ```
 
 # Hiding Series Items
-You can tell Androidplot not to generate a legend item for a Series by configuring it's associated
+You can tell Androidplot not to generate a legend item for a `Series` by configuring it's associated
 `Formatter`:
 
 ```java
@@ -56,4 +56,8 @@ plot.getLegend().setLegendItemComparator(myComparator);
 ```
 
 Using a custom `Comparator` in conjunction with `ROW_MAJOR` and `COLUMN_MAJOR` properties on the `TableModel`
-(show above) gives you full control over the display ordering of your legend entries.
+(show above) gives you full control over the display ordering of your legend entries.
+
+# Positioning and Resizing
+The legend is just an implementation of a Widget and is positioned and resized in the same ways
+that all Widget instances are positioned.  See the [Plot Composition](plot_composition.md) doc for details.
diff --git a/docs/plot_composition.md b/docs/plot_composition.md
@@ -1,39 +1,39 @@
 # Plot Composition
-All plots in Androidplot inherit from the abstract base class Plot which provides common behaviors
-for all Plot implementations.
+All plots in Androidplot inherit from the abstract base class `Plot` which provides common behaviors
+for all `Plot` implementations.
 
 # Widgets
-Plots are composed of one or more Widgets.  A Widget is an abstraction of a visual
+Plots are composed of one or more Widgets.  A `Widget` is an abstraction of a visual
 component that may be positioned and scaled within the visible area of a Plot.  For example,
-an XY Plot is typically composed of these 5 Widgets:
+an `XYPlot` is typically composed of these 5 `Widgets`:
 
 * Title
 * Graph
 * Domain Label
 * Range Label
-* Legend
+* [Legend](legend.md)
 
-All Plot implementations will contain at least one default Widget providing the core
-behavior encapsulated by that Plot.  In addition to moving and scaling these Widgets, developers may
-also extend them and replace the Plot's default instance with the derived implenentation in order to 
+All implementations of `Plot` will contain at least one default `Widget` providing the core
+behavior encapsulated by that `Plot`.  In addition to moving and scaling a `Widget`, developers may
+also extend them and replace the `Plot` instance's default instance with the derived implementation in order to 
 get custom behavior.
 
 # The LayoutManager
-The LayoutManager provides the logic for visually positioning and scaling Widgets; all Plot implementations
-contain an instance of LayoutManager that can be retrieved via `Plot.getLayoutManager()`.
+The `LayoutManager` provides the logic for visually positioning and scaling Widgets; all `Plot` implementations
+contain an instance of `LayoutManager` that can be retrieved via `Plot.getLayoutManager()`.
 
 ## Z-Indexing
 Z-indexing is a 2D drawing concept which associates each drawable entity with a value that determines
 which elements get drawn onto the screen first, producing the visual effect that certain elements appear
 on top of others.
 
 While Androidplot uses the term "z-index" it's implemented internally as a linked list to prevent the possibility
-of duplicate index values and therefore ensuring that the drawing order of Widgets is always explicit.
+of duplicate index values and therefore ensuring that `Widget` drawing order is always explicit.
 The [Layerable](../androidplot-core/src/main/java/com/androidplot/util/Layerable.java) interface 
-defines methods used for manipulating the z-index of a Widget.
+defines methods used for manipulating the z-index of a `Widget`.
 
 ## Adding & Removing Widgets
-New Widgets can be added either to the front or back of the z-index using these methods:
+New `Widget` instances can be added either to the front or back of the z-index using these methods:
 
 * `LayoutManager.addToTop(Widget)`
 * `LayoutManager.addToBottom(Widget)`
