Updated readme

I just read the documentation you linked to. And it says I should write `@module <module identifier>` at the top of the file regardless of the format. Is that correct? It also says I can use the second format as long as I mark the function using `@alias module:jacket`

Are you okay with our code using `@alias`?