add some internal docs