The following sentence was confusing:

---
However, the file paths must be relative to the doc or docs directory.
---

This actually described the Rake task process, when editing manually
the paths must be relative to each other.