# Should Documenter be part of Project.toml?

**URL:** <https://discourse.julialang.org/t/should-documenter-be-part-of-project-toml/73692>\
**Category:** General Usage\
**Tags:** question, documenter\
**Created:** [December 28, 2021, 12:40am UTC](https://discourse.julialang.org/t/should-documenter-be-part-of-project-toml/73692 "2021-12-28T00:40:27Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![ufechner7](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/ufechner7/32/51363_2.png) [@ufechner7](https://discourse.julialang.org/u/ufechner7)\
**Post date:** [December 28, 2021, 12:40am UTC](https://discourse.julialang.org/t/should-documenter-be-part-of-project-toml/73692/1 "2021-12-28T00:40:27Z")

</div>

I have a main Project.toml, and a second one in the folder docs.

I removed Documenter from the main Project.toml, but now I cannot build any longer the documentation locally, even though the Project.toml in the docs folder exists. Content:

```julia
[deps]
Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
KiteUtils = "90980105-b163-44e5-ba9f-8b1c83bb0533"

```

How can I tell Julia to use this nested Project.toml ?

---

<div class="post-metadata">

**Author:** ![TheCedarPrince](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/thecedarprince/32/17323_2.png) [@TheCedarPrince](https://discourse.julialang.org/u/TheCedarPrince)\
**Post date:** [December 28, 2021, 3:28am UTC](https://discourse.julialang.org/t/should-documenter-be-part-of-project-toml/73692/2 "2021-12-28T03:28:04Z")

</div>

Hi @ufechner7 ,

I use the [`make.jl`](https://github.com/TheCedarPrince/LuxCat.jl/tree/main/docs) approach in my set-up for [LuxCat.jl](https://github.com/TheCedarPrince/LuxCat.jl).  
Perhaps this approach may assist in your situation?  
It’s a bit hard to tell what exactly your problem is without seeing the repo or code - are you at liberty to show it?  
Additionally, here is my docs deployment yaml via GitHub Actions if you deploy your docs somewhere: [https://github.com/TheCedarPrince/LuxCat.jl/blob/178a34fb0e169eac6d8669c9f10d8ac028e5c0e2/.github/workflows/ci.yml#L44](https://github.com/TheCedarPrince/LuxCat.jl/blob/178a34fb0e169eac6d8669c9f10d8ac028e5c0e2/.github/workflows/ci.yml#L44)

Let me know if you have additional questions - happy to attempt helping!

~ tcp 🌳

---

<div class="post-metadata">

**Author:** ![ufechner7](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/ufechner7/32/51363_2.png) [@ufechner7](https://discourse.julialang.org/u/ufechner7)\
**Post date:** [December 28, 2021, 1:55pm UTC](https://discourse.julialang.org/t/should-documenter-be-part-of-project-toml/73692/3 "2021-12-28T13:55:43Z")

</div>

Thanks for your answer!  
You can find my package here: [GitHub - ufechner7/KiteUtils.jl: Utilities for kite power system simulations](https://github.com/ufechner7/KiteUtils.jl)

I think I solved my problem: To create the documentation locally, I had to:

1. navigate to the docs folder
2. run `julia --project `
3. `using Pkg; Pkg.resolve() `
4. `include("make.jl")`

So the problem is solved, but I guess it should be documented somewhere…

---

<div class="post-metadata">

**Author:** ![adigitoleo](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/adigitoleo/32/27478_2.png) [@adigitoleo](https://discourse.julialang.org/u/adigitoleo)\
**Post date:** [January 17, 2022, 11:48am UTC](https://discourse.julialang.org/t/should-documenter-be-part-of-project-toml/73692/4 "2022-01-17T11:48:04Z")

</div>

I am also still looking for the optimal Documenter.jl workflow. The only thing I can suggest, which is what I am thinking of using, is to use the `Pkg` module to automate some of the environment switching in `docs/make.jl`. By [doing this](https://git.sr.ht/~adigitoleo/PlateMotionRequests.jl/tree/main/item/docs/make.jl#L2), I can run `make.jl` and it will do the right thing even if I forget about switching into the docs environment.