Update README.md

Clarified the rules on resource titles and quoting. As seen on Issue#79, there's some confusion as to the precedence.
Merge pull request #168 from levilovelock/patch-1

Update README.md
Fix where . is located in docs
Merge pull request #169 from gmjosack/master

Fix where . is located in docs
Use the current workdir as reference to calculate the expanded_path of a filename.

This resolves issues with autoloader layout detection when the module dir
is a symlink.

```
.
├── foobar -> foo-bar/
└── foo-bar
    └── manifests
            ├── foo.pp
            └── init.pp
```

WARNING: class not documented on line 1
ERROR: foobar not in autoload module layout on line 1
WARNING: class not documented on line 1
ERROR: foobar::foo not in autoload module layout on line 1
Fix the check_classes check for certain cases.

Examples:

File: modules/foobar/manifests/init.pp
Content: 'class bar { }'

File: modules/foobar/manifests/fail.pp
Content: 'class bar::fail {}'

These 2 examples do not throw the autoloader error while they really should.