add docs for @altns, as well as making the docs parser less confused from so many `@` signs