describe beacon
add docs for priority and hidden
a bit more on categories