adding some to docs about sml, but much more needed