Stick to the usual Moodle boilerplate
Copy the README into the built archive

The Moodle plugins site uses this for extended documentation, and it'll
possibly be handy for administrators too.