Methods for deploying documentation

I’m confused about the necessary steps to deploy documentation. The documentation seems to describe two (overlapping?) methods:

  1. Run Documenter.deploydocs() locally to push docs to a specified remote repo.
  2. Use CI to trigger deployment (essentially using deploydocs() remotely) in a much more complex to configure.

Is that right. If so, isn’t it simpler to just do 1? What am I missing?

Method 2. is using 1. so they are not exactly different methods.

You can of course deploy from your local machine if you like (but no one does). The only extra configuration necessary is to upload a deploy key as described in the docs there.

1 Like

So 2 is (very much) prefferred? Why is that?

Because it happens automatically when you update your package so you don’t have to worry about forgetting it.