shm.md - updated documentation