Best practices to work with chef

README.md

@@ -98,6 +98,7 @@ The aim of this project is to have a quick guide of what to do when an emergency
 * [Speed up chefspec tests](howto/chefspec.md#tests-are-taking-too-long-to-run)
 * [Retrieve old values in a Chef vault](howto/retrieve-old-chef-vault-values.md)
 * [Manage Chef Cookbooks](howto/chef-documentation.md)
+* [Best practices and tips](howto/chef-best-practices.md)
 ### Work with CI Infrastructure

howto/chef-best-practices.md

+## Chef best practices
+
+### `role` vs `roles`
+
+`knife (search|ssh|..) role:my-role ...` returns only nodes for which `my-role` is specified in their run_list, not nested ones.
+
+`knife (search|ssh|..) roles:my-role ...` returns all nodes which has `my-role`, directly and nestly specified.
+
+