# Methods for deploying documentation

**URL:** <https://discourse.julialang.org/t/methods-for-deploying-documentation/64607>\
**Category:** New to Julia\
**Tags:** documenter\
**Created:** [July 13, 2021, 10:25pm UTC](https://discourse.julialang.org/t/methods-for-deploying-documentation/64607 "2021-07-13T22:25:13Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![orome](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/orome/32/26965_2.png) [@orome](https://discourse.julialang.org/u/orome)\
**Post date:** [July 13, 2021, 10:25pm UTC](https://discourse.julialang.org/t/methods-for-deploying-documentation/64607/1 "2021-07-13T22:25:13Z")

</div>

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

1. Run [`Documenter.deploydocs()`](https://juliadocs.github.io/Documenter.jl/stable/lib/public/#Documenter.deploydocs) locally to push docs to a specified remote repo.
2. Use [CI to trigger deployment](https://juliadocs.github.io/Documenter.jl/stable/man/hosting/#Hosting-Documentation) (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?

---

<div class="post-metadata">

**Author:** ![fredrikekre](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/fredrikekre/32/1688_2.png) [@fredrikekre](https://discourse.julialang.org/u/fredrikekre)\
**Post date:** [July 13, 2021, 10:47pm UTC](https://discourse.julialang.org/t/methods-for-deploying-documentation/64607/2 "2021-07-13T22:47:22Z")

</div>

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.

---

<div class="post-metadata">

**Author:** ![orome](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/orome/32/26965_2.png) [@orome](https://discourse.julialang.org/u/orome)\
**Post date:** [July 13, 2021, 11:08pm UTC](https://discourse.julialang.org/t/methods-for-deploying-documentation/64607/3 "2021-07-13T23:08:27Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![fredrikekre](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/fredrikekre/32/1688_2.png) [@fredrikekre](https://discourse.julialang.org/u/fredrikekre)\
**Post date:** [July 13, 2021, 11:37pm UTC](https://discourse.julialang.org/t/methods-for-deploying-documentation/64607/4 "2021-07-13T23:37:47Z")

</div>

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