README.md in roadie-3.0.3 vs README.md in roadie-3.0.4

- old
+ new

@@ -251,9 +251,17 @@ This project follows [Semantic Versioning](http://semver.org/) and has been since version 1.0.0. FAQ --- +### Why is my markup changed in subtle ways? + +Roadie uses Nokogiri to parse and regenerate the HTML of your email, which means that some unintentional changes might show up. + +One example would be that Nokogiri might remove your ` `s in some cases. + +Another example is Nokogiri's lack of HTML5 support, so certain new element might have spaces removed. I recommend you don't use HTML5 in emails anyway because of bad email client support (that includes web mail!). + ### I'm getting segmentation faults (or other C-like problems)! What should I do? ### Roadie uses Nokogiri to parse the HTML of your email, so any C-like problems like segfaults are likely in that end. The best way to fix this is to first upgrade libxml2 on your system and then reinstall Nokogiri. Instructions on how to do this on most platforms, see [Nokogiri's official install guide](http://nokogiri.org/tutorials/installing_nokogiri.html).