Commits

Jonathan Eunice committed 0340a32

tweaked

  • Participants
  • Parent commits a33d37a

Comments (0)

Files changed (3)

 options
 =======
 
-``options`` helps encapsulate options and configuration data using a
-layered stacking model (a.k.a. nested contexts).
+``options`` helps represent option and configuration data in
+a clean, high-function way.  Changes to options can "overlay"
+earlier or default
+settings.
 
-For most functions and many classes, ``options``
-is overkill and not recommended.
-Python's already-flexible function arguments, ``*args``,
+For most functions and classes, ``options``
+is overkill.
+Python's function arguments, ``*args``,
 ``**kwargs``, and inheritance patterns are elegant and sufficient
 for 99.9% of all development situations.
 ``options``
-is for the other 0.1%: 
+is for the top 0.1%:
 
-  * highly functional classes, 
-  * with many different features and options, 
+  * highly functional classes (or functions),
+  * with many different features and options,
   * which might be adjusted or overriden at any time,
   * yet that need "reasonable" or "intelligent" defaults, and
   * that yearn for a simple, unobtrusive API.
 
 In those cases, Python's simpler built-in, inheritance-based model
-adds complexity as non-trivial options and argument-management
+adds complexity. Non-trivial options and argument-management
 code spreads through many individual methods. This is where
-``options``'s delegation-based approach begins to shine.
+``options``'s layered, delegation-based approach begins to shine.
 
 .. image:: http://d.pr/i/6JI4+
     :align: center

File docs/index.rst

 In those cases, Python's simpler built-in, inheritance-based model
 adds complexity. Non-trivial options and argument-management
 code spreads through many individual methods. This is where
-``options``'s delegation-based approach begins to shine.
+``options``'s layered, delegation-based approach begins to shine.
 
 .. image:: http://d.pr/i/6JI4+
     :align: center

File options/version.py

-__version__ = '1.1.2'
+__version__ = '1.1.3'