add req.primary and fix docs