general documentation discussion applies to this file