scene: small changes in docs

addresses comments by Eric and Luke