README.markdown in deface-0.5.1 vs README.markdown in deface-0.5.2a
- old
+ new
@@ -5,17 +5,17 @@
It allows you to easily target html & erb elements as the hooks for customization using CSS selectors as supported by Nokogiri.
Demo & Testing
---------------
-You can play with Deface and see it's parsing in action at [deface.heroku.com](http://deface.heroku.com)
+You can play with Deface and see its parsing in action at [deface.heroku.com](http://deface.heroku.com)
Deface::Override
=======
-A new instance of the Deface::Override class is initialized for each customization you wish to define. When initializing a new override you must supply only one Target, Action & Source parameter and any number of Optional parameters. Note, the source parameter is not required when the "remove" action is specified.
+A new instance of the Deface::Override class is initialized for each customization you wish to define. When initializing a new override you must supply only one Target, Action & Source parameter and any number of Optional parameters. Note: the source parameter is not required when the "remove" action is specified.
Target
------
* <tt>:virtual_path</tt> - The template / partial / layout where the override should take effect eg: *"shared/_person"*, *"admin/posts/new"* this will apply to all controller actions that use the specified template.
@@ -115,10 +115,10 @@
======
Deface uses the amazing Nokogiri library (and in turn libxml) for parsing HTML / view files, in some circumstances either Deface's own pre-parser or libxml's will fail to correctly parse a template. You can avoid such issues by ensuring your templates contain valid HTML. Some other caveats include:
1. Ensure that your layout views include doctype, html, head and body tags in a single file, as Nokogiri will create such elements if it detects any of these tags have been incorrectly nested.
-2. Parsing will fail and result in invalid output if ERB blocks are responsible for closing a HTML tag what was opened normally, i.e. don't do this:
+2. Parsing will fail and result in invalid output if ERB blocks are responsible for closing an HTML tag that was opened normally, i.e. don't do this:
<div <%= ">" %>