minor fix to steps following markup change
minor improvement to the docs