-- improving shel crud interface documentation