# Version of package = Version of documentation != Version of \`project.toml\`

**URL:** https://discourse.julialang.org/t/version-of-package-version-of-documentation-version-of-project-toml/20582
**Category:** New to Julia
**Created:** [February 8, 2019, 1:05pm UTC](https://discourse.julialang.org/t/version-of-package-version-of-documentation-version-of-project-toml/20582 "2019-02-08T13:05:22Z")
**Posts on this page:** 7
**Page:** 1

<div class="post-metadata">

### Author: ![timueh](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/timueh/32/12379_2.png) [@timueh](https://discourse.julialang.org/u/timueh)
#### Post date: [February 8, 2019, 1:05pm UTC](https://discourse.julialang.org/t/version-of-package-version-of-documentation-version-of-project-toml/20582/1 "2019-02-08T13:05:22Z")

</div>

I have a question about versioning. On GitHub, I can add a version number to my release of the master branch. This will then become the version of the package _and_ the version of the documentation that `Documenter.jl` creates. Correct?

Then, there is `project.toml` where I can enter a version number _manually_. Arguably, the version from `project.toml` _should_ be identical with the version of my latest release of the master branch. And I have to keep track of this myself, correct?

Does that mean the following: before I create a release on GitHub to version `vX.Y.Z`, I should add `version = "vX.Y.Z"` manually to the `project.toml`, and then push it to the master branch?

---

<div class="post-metadata">

### Author: ![Tamas\_Papp](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tamas_papp/32/25949_2.png) [@Tamas\_Papp](https://discourse.julialang.org/u/Tamas_Papp)
#### Post date: [February 8, 2019, 1:12pm UTC](https://discourse.julialang.org/t/version-of-package-version-of-documentation-version-of-project-toml/20582/2 "2019-02-08T13:12:16Z")

</div>

Working out the exact process for this is WIP, see

[https://github.com/JuliaLang/Pkg.jl/issues/849](https://github.com/JuliaLang/Pkg.jl/issues/849)

[https://github.com/JuliaLang/Pkg.jl/issues/351](https://github.com/JuliaLang/Pkg.jl/issues/351)

In the meantime, I think the best course is to just omit the `version` from the project file.

---

<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: [February 8, 2019, 2:47pm UTC](https://discourse.julialang.org/t/version-of-package-version-of-documentation-version-of-project-toml/20582/3 "2019-02-08T14:47:56Z")

</div>

> [@timueh](#):
>
> Does that mean the following: before I create a release on GitHub to version `vX.Y.Z` , I should add `version = "vX.Y.Z"` manually to the `project.toml` , and then push it to the master branch?

One option is to

> [@Tamas\_Papp](#):
>
> omit the `version` from the project file.

but otherwise you have to update it. This consistency is actually checked now when you register a package.

---

<div class="post-metadata">

### Author: ![timueh](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/timueh/32/12379_2.png) [@timueh](https://discourse.julialang.org/u/timueh)
#### Post date: [February 8, 2019, 2:58pm UTC](https://discourse.julialang.org/t/version-of-package-version-of-documentation-version-of-project-toml/20582/4 "2019-02-08T14:58:29Z")

</div>

So the two options are:

1. omit the `version` entry in `projec.toml`, or
2. update `project.toml` first, and _then_ release.

---

<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: [February 8, 2019, 3:28pm UTC](https://discourse.julialang.org/t/version-of-package-version-of-documentation-version-of-project-toml/20582/5 "2019-02-08T15:28:55Z")

</div>

> [@timueh](#):
>
> So the two options are:
> 
> 1. omit the `version` entry in `projec.toml` , or
> 2. update `project.toml` first, and _then_ release.

Correct.

---

<div class="post-metadata">

### Author: ![lostella](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/lostella/32/356_2.png) [@lostella](https://discourse.julialang.org/u/lostella)
#### Post date: [July 7, 2019, 3:47pm UTC](https://discourse.julialang.org/t/version-of-package-version-of-documentation-version-of-project-toml/20582/6 "2019-07-07T15:47:15Z")

</div>

Do these suggestions still hold? Because from [https://github.com/JuliaRegistries/Registrator.jl](https://github.com/JuliaRegistries/Registrator.jl) I understand that the `version` field of Project.toml _must_ be set; so option 2 seems the only viable.

---

<div class="post-metadata">

### Author: ![timueh](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/timueh/32/12379_2.png) [@timueh](https://discourse.julialang.org/u/timueh)
#### Post date: [July 8, 2019, 5:46am UTC](https://discourse.julialang.org/t/version-of-package-version-of-documentation-version-of-project-toml/20582/7 "2019-07-08T05:46:27Z")

</div>

I agree. With the new `Registrator`, you set the version field in the `project.toml` to the desired version.
