Running compile-json also gives us .js files

We're not using them in this example, but it's a bit confusing if
they're not mentioned because the tool does produce them too.
Explicitly mention which PO file we're looking at
Bug is fixed (as of i18n-abide@0.0.8beta6)

Let's show the correct output because it contains the good stuff :)
Typo
Possible typo

Depending on the effect/style you're trying to get, it may also
be perfectly reasonable spelling, hence a separate easy-to-rever
commit :)
Expand L10n acronym the first time it's used
The script has a .js extension in its name
Fix misplaced brackets in format examples

These examples don't work as they stand:

  https://github.com/fmarier/abide-demo/commit/c6c5e5bd45c929efcedf65f0e77053825a14954c
Use bullets in section about inflexible designs

This seems to read a bit better because these three items all
start with action verbs.
Rephrase this "systematic design way"

I didn't understand the original, I'm just guessing here...
Add a hyphen to "database backed"
Remove two somewhat redundant sentences

I'm not sure these sentences add a lot to their respective sections
and I would suggest taking them out.
Merge three sentence fragments into one long sentence

Not entirely sure this is the best way to improve this, but the
sentence fragment felt a bit weird to me on their own.
Avoid repetition of "a larger audience"
Merge pull request #4 from fmarier/francois-review

Francois' review