doc: clarify the importance of the vcs_list