add some docs / pointers to workplace.py