diff --git a/README.md b/README.md
index 61a1ef2d..08f62b97 100644
--- a/README.md
+++ b/README.md
@@ -267,7 +267,7 @@ Type | Aliases
 
 
 
-__Tip__: You can see the default value for a given argument with `default(arg::Symbol)`, and set the default value with `default(arg::Symbol, value)`
+__Tip__: You can see the default value for a given argument with `default(arg::Symbol)`, and set the default value with `default(arg::Symbol, value)` or `default(; kw...)`.  For example set the default window size and whether we should show a legend with `default(size=(600,400), leg=false)`.
 
 __Tip__: When plotting multiple lines, you can set all series to use the same value, or pass in an array to cycle through values.  Example:
 
@@ -286,6 +286,7 @@ __Tip__: Call `gui()` to display the plot in a window.  Interactivity depends on
 - [x] Plot vectors/matrices/functions
 - [x] Plot DataFrames
 - [x] Grouping
+- [ ] Annotations
 - [ ] Scales
 - [ ] Categorical Inputs (strings, etc... for hist, bar? or can split one series into multiple?)
 - [ ] Custom markers
diff --git a/docs/example_generation.jl b/docs/example_generation.jl
index fbc8757b..b2ea6765 100644
--- a/docs/example_generation.jl
+++ b/docs/example_generation.jl
@@ -38,7 +38,7 @@ const examples = PlotExample[
               "Use the `axis` arguments.\n\nNote: Currently only supported with Qwt and PyPlot",
               [:(plot(Vector[randn(100), randn(100)*100]; axis = [:l,:r], ylabel="LEFT", yrightlabel="RIGHT"))]),
   PlotExample("Vectors w/ pluralized args",
-              "Plot multiple series with different numbers of points.  Mix arguments that apply to all series (singular... see `marker`) with arguments unique to each series (pluralized... see `colors`).",
+              "Plot multiple series with different numbers of points.  Mix arguments that apply to all series (marker/markersize) with arguments unique to each series (colors).",
               [:(plot(Vector[rand(10), rand(20)]; marker=:ellipse, markersize=8, c=[:red,:blue]))]),
   PlotExample("Build plot in pieces",
               "Start with a base plot...",
diff --git a/docs/readme_template.md b/docs/readme_template.md
index f6f28cef..feb10aa1 100644
--- a/docs/readme_template.md
+++ b/docs/readme_template.md
@@ -189,7 +189,7 @@ Markers:
 [[MARKERS_TABLE]]
 
 
-__Tip__: You can see the default value for a given argument with `default(arg::Symbol)`, and set the default value with `default(arg::Symbol, value)`
+__Tip__: You can see the default value for a given argument with `default(arg::Symbol)`, and set the default value with `default(arg::Symbol, value)` or `default(; kw...)`.  For example set the default window size and whether we should show a legend with `default(size=(600,400), leg=false)`.
 
 __Tip__: When plotting multiple lines, you can set all series to use the same value, or pass in an array to cycle through values.  Example: