If a README file doesn't have an extension, GitHub will parse it as Markdown. Because our README files are ReST, this results in some ugly (and not very useful) READMEs when visiting the repository on GitHub.
For example, see: https://github.com/bro/btest#readme
There are two options we could take to fix this: rename README to README.rst, or create a symlink. I tried out the symlink option here, and I think the result is much more useful: https://github.com/grigorescu/btest#readme
The affected repos are:
broctl (broctl's README just instructs users to see doc/broctl.rst. This could just be a symlink)
bromagic (this can probably be deleted?)