docs, undercut warning

pre work for a refactor of gear maker