reduce duplication between readme and docs