found an acceptable way of documenting the namespace factory instance problem (see vector)
documented some more