Suggest to add instructions that if the initial overcloud creation fails, that the user should run the command "openstack stack delete overcloud" before attempting again
openstack stack delete overcloud --yes --wait
Suggest also to mention that if you run the above command you can see the progress instead of having to repeatedly run 'openstack stack list' to see if it has completed.
There's legitimacy to this BZ. However, the only thing to be aware of is that customers who have created their overcloud and are updating with "openstack overcloud deploy" might run into a failure and think they have to run "openstack overcloud delete", which they shouldn't do because it'll delete their running overcloud. Might require a note to specify this information.