# Cadence Of Regenerating Documentation

**URL:** <https://racket.discourse.group/t/cadence-of-regenerating-documentation/3474>\
**Category:** General\
**Tags:** question, documentation\
**Created:** [January 9, 2025, 5:42pm UTC](https://racket.discourse.group/t/cadence-of-regenerating-documentation/3474 "2025-01-09T17:42:07Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![OldDutchCap](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/olddutchcap/32/2037_2.png) [@OldDutchCap](https://racket.discourse.group/u/OldDutchCap)\
**Post date:** [January 9, 2025, 5:42pm UTC](https://racket.discourse.group/t/cadence-of-regenerating-documentation/3474/1 "2025-01-09T17:42:07Z")

</div>

I was able to submit a change to the Racket Documentation in this section of it:

[https://docs.racket-lang.org/guide/scripts.html](https://docs.racket-lang.org/guide/scripts.html)

The change was accepted several days ago but I don't see the changed text on the site. I don't mind because I know what I need to know but I wouldn't have bothered making my change if I didn't think it was something others could use as well. So now I'm wondering--how often does the documentation get rebuilt? Is this something I have to ask for?

Just curious.

---

<div class="post-metadata">

**Author:** ![shhyou](https://avatars.discourse-cdn.com/v4/letter/s/ccd318/32.png) [@shhyou](https://racket.discourse.group/u/shhyou)\
**Post date:** [January 9, 2025, 7:35pm UTC](https://racket.discourse.group/t/cadence-of-regenerating-documentation/3474/2 "2025-01-09T19:35:31Z")

</div>

😃  
Daily: [21.2&nbsp;Scripts](https://users.cs.utah.edu/plt/snapshots/current/doc/guide/scripts.html#%28part._.Windows_.Batch_.Files%29)

The `docs` site hosts v8.15 atm, so it will display the change when v8.16 lands.

---

<div class="post-metadata">

**Author:** ![OldDutchCap](https://yyz2.discourse-cdn.com/free1/user_avatar/racket.discourse.group/olddutchcap/32/2037_2.png) [@OldDutchCap](https://racket.discourse.group/u/OldDutchCap)\
**Post date:** [January 9, 2025, 8:06pm UTC](https://racket.discourse.group/t/cadence-of-regenerating-documentation/3474/3 "2025-01-09T20:06:19Z")

</div>

Thanks! Just wanted to ensure I hadn't missed some detail!

---

<div class="post-metadata">

**Author:** ![sorawee](https://avatars.discourse-cdn.com/v4/letter/s/ea5d25/32.png) [@sorawee](https://racket.discourse.group/u/sorawee)\
**Post date:** [January 9, 2025, 8:31pm UTC](https://racket.discourse.group/t/cadence-of-regenerating-documentation/3474/4 "2025-01-09T20:31:01Z")

</div>

To add to what @shhyou said:

Documentation update mirrors functionality update.

Say that you install the latest version of Racket regularly (Racket 8.15). Then, in the development version, we added a function `add2` to the language, with the aim to release it as a part of Racket 8.16. Wouldn't it be confusing to see the documentation for `add2` on the documentation page when Racket 8.16 is not even released yet?

That's why documentation is frozen for "main distribution" packages (packages that are installed along with Racket installation, like rackunit, htdp, and the Racket language itself), and will only be updated when a new version is released.

For non-"main distribution" packages (user packages), they can be updated almost immediately after a change is published, and the documentation is usually built/updated daily.

What I said above applies to [https://docs.racket-lang.org/](https://docs.racket-lang.org/) and [https://download.racket-lang.org/](https://download.racket-lang.org/).

@shhyou also mentioned snapshot versions ([https://snapshot.racket-lang.org/](https://snapshot.racket-lang.org/)), which is usually updated daily. The site contains installers for development versions ([https://users.cs.utah.edu/plt/snapshots/current/](https://users.cs.utah.edu/plt/snapshots/current/)), as well as their documentation ([https://users.cs.utah.edu/plt/snapshots/current/doc/index.html](https://users.cs.utah.edu/plt/snapshots/current/doc/index.html)). So if you want to view your change, you can view it from there.
