# Using Documenter.jl

**URL:** https://discourse.julialang.org/t/using-documenter-jl/1115
**Category:** General Usage
**Created:** [December 23, 2016, 2:26pm UTC](https://discourse.julialang.org/t/using-documenter-jl/1115 "2016-12-23T14:26:53Z")
**Posts on this page:** 7
**Page:** 1

<div class="post-metadata">

### Author: ![Balinus](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/balinus/32/243_2.png) [@Balinus](https://discourse.julialang.org/u/Balinus)
#### Post date: [December 23, 2016, 2:26pm UTC](https://discourse.julialang.org/t/using-documenter-jl/1115/1 "2016-12-23T14:26:53Z")

</div>

Hello,

I’m trying to deploy some basic documentation for my package [ClimateTools.jl](https://github.com/Balinus/ClimateTools.jl) using Documenter.jl.

I have an error when trying to run make.jl from the command line

`[user@doris docs]$ julia --color=yes /home/user/.julia/v0.5/ClimateTools/docs/make.jl fatal: Not a git repository (or any parent up to mount point /home) Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set). ERROR: LoadError: failed process: Process(`git rev-parse --short HEAD`, ProcessExited(128)) [128]`

I’ve followed the guide and I can’t see where I did something wrong. ssh keys are generated and saved on github and Travis. I do have a gh-pages branch. Though I admit this part is not clear: I do everything on master and it’s Travis that will take care of the gh-pages branch with built docs?.

Right now, you can see the current state of my attempt on the github repo.

I’m really lost right now! Tried various combinations using the “Examples” found in the “Documenter.jl documentation”. No success so far.

Any help or hint will be appreciated! 🙂

---

<div class="post-metadata">

### Author: ![Balinus](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/balinus/32/243_2.png) [@Balinus](https://discourse.julialang.org/u/Balinus)
#### Post date: [December 23, 2016, 8:11pm UTC](https://discourse.julialang.org/t/using-documenter-jl/1115/2 "2016-12-23T20:11:07Z")

</div>

I re-did everything and no longer have the “git” problem.

However, documentation does not seem to appear on gh-pages. I think I am lost at the “gh-pages” branch step. I mean, do I need to add the “build” directory on the gh-pages? Since they are in the .gitignore file, I need to add them with the “-f” flag. That’s what I tried and I don’t have more success on this front.

in the repo settings, Github pages is enabled and set on the gh-pages branch. Travis is building right now. We’ll see if it works!

edit - Well, didn’t worked. I’m completely lost now.

---

<div class="post-metadata">

### Author: ![Balinus](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/balinus/32/243_2.png) [@Balinus](https://discourse.julialang.org/u/Balinus)
#### Post date: [December 23, 2016, 8:13pm UTC](https://discourse.julialang.org/t/using-documenter-jl/1115/3 "2016-12-23T20:13:59Z")

</div>

edit - Just read that on Documenter.jl documentation:

“Note that the hosted documentation does not update when you make pull requests; you see updates only when you merge to master or push new tags.”

What does it mean actually? I’m using to do simple

`git add file1 git commit -m "msg" git push origin master`

is that enough or is there another step I need to do to make it happen? Thanks!

---

<div class="post-metadata">

### Author: ![kristoffer.carlsson](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kristoffer.carlsson/32/22_2.png) [@kristoffer.carlsson](https://discourse.julialang.org/u/kristoffer.carlsson)
#### Post date: [December 23, 2016, 8:17pm UTC](https://discourse.julialang.org/t/using-documenter-jl/1115/4 "2016-12-23T20:17:45Z")

</div>

I believe you need a `deploydocs()` function call as well in your `make.jl`. See for example [https://github.com/KristofferC/ContMechTensors.jl/blob/master/docs/make.jl](https://github.com/KristofferC/ContMechTensors.jl/blob/master/docs/make.jl)

---

<div class="post-metadata">

### Author: ![mike](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/mike/32/39_2.png) [@mike](https://discourse.julialang.org/u/mike)
#### Post date: [December 23, 2016, 8:18pm UTC](https://discourse.julialang.org/t/using-documenter-jl/1115/5 "2016-12-23T20:18:06Z")

</div>

`deploydocs` will only push updated docs to the repo when the [`julia = `](https://github.com/Balinus/ClimateTools.jl/commit/23ad9cc1f53add3e56499de156c39ea67e0e6b0a#diff-d443640aba44c5cb789f997af92abae4L10) keyword matches one of the versions listed in [the travis config](https://github.com/Balinus/ClimateTools.jl/blob/64bde61fd1b4046c51b603edb114089b9e61186e/.travis.yml#L7-L9). So changing `julia = "0.5"` to `julia = "release"` should be sufficient to get it to deploy I think.

---

<div class="post-metadata">

### Author: ![Balinus](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/balinus/32/243_2.png) [@Balinus](https://discourse.julialang.org/u/Balinus)
#### Post date: [December 23, 2016, 8:23pm UTC](https://discourse.julialang.org/t/using-documenter-jl/1115/6 "2016-12-23T20:23:02Z")

</div>

Thanks! i thought it was there. I guess I modified this file one time too many! I’ve added it now and put julia = “release”, as suggested by @mike

Fingers crossed!

---

<div class="post-metadata">

### Author: ![Balinus](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/balinus/32/243_2.png) [@Balinus](https://discourse.julialang.org/u/Balinus)
#### Post date: [December 23, 2016, 8:38pm UTC](https://discourse.julialang.org/t/using-documenter-jl/1115/7 "2016-12-23T20:38:04Z")

</div>

Thanks! It worked! I spend so many hours on that!

Now I need to tag a version so that the stable badge leads to somewhere. 🙂
