Update the docs about submodules and action ordering.

[KubaO]

Fixes #91

[mpdude]

I prefer not to merge this unless I fully understand the problem and we have discussed possible alternative (?) solutions. I have opened https://github.com/actions/checkout/issues/973 to co-ordinate with the actions/checkout folks.