Fix documentation around Actor README & video embedding

[TC-MO]

Based on this discussion, the documentation regarding good practices in Actor README is incomplete and needs to be updated. Especially around automatic video embedding. (We can use that opportunity to audit all of it and double check the clarity & accuracy)