Marble diagrams for Subject subclasses

Adding marble diagrams and making the javadoc descriptions match the
terminology used elsewhere in the docs (e.g. "emit", "item")