added some doc plus a WARNING