some theme documentation (references #811)