vars_files haven't been discussed yet

I think this is a chapter ordering thing... vars_files have not actually be explained yet (aside from a mention of them in the note right above, which also might need reconsidering?) I think they do get introduced in the next section 'Variables'.

docsite/rst/playbooks_roles.rst

@@ -153,7 +153,7 @@ Roles
 
 .. versionadded:: 1.2
 
-Now that you have learned about :ref:`vars_files <variable_file_separation_details>`, tasks, and handlers, what is the best way to organize your playbooks?
+Now that you have learned about tasks and handlers, what is the best way to organize your playbooks?
 The short answer is to use roles!  Roles are ways of automatically loading certain vars_files, tasks, and
 handlers based on a known file structure.  Grouping content by roles also allows easy sharing of roles with other users.