doc: clarify on the importance of the vcs_list