Docs are inconsistent with latest release

[eric-czech]

I noticed that the docs track changes beyond the most recent release, which causes some simple inconsistencies such as unpack-fields being documented without existing in v1.88.0 (latest release at TOW).

I apologize if this is obvious, but is there a way to view docs on https://hamilton.apache.org/ for past releases, or at least the most current stable release?

[skrawcz]

yeah sorry we're behind on pushing this. Hopefully soon. Because we have to self host the docs, we need some contribution here to help enable storing past versions.

…

On Thu, Jul 24, 2025 at 6:01 AM Eric Czech ***@***.***> wrote: *eric-czech* created an issue (apache/hamilton#1357) <#1357> I noticed that the docs track changes beyond the most recent release, which causes some simple inconsistencies such as unpack-fields <https://hamilton.apache.org/concepts/function-modifiers/#unpack-fields> being documented without existing in v1.88.0 <https://github.com/apache/hamilton/releases/tag/sf-hamilton-1.88.0> (latest release at TOW). I apologize if this is obvious, but is there a way to view docs on https://hamilton.apache.org/ for past releases, or at least the most current stable release? — Reply to this email directly, view it on GitHub <#1357>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AARYMB3SAG5JU2IDJQIKG6L3KDKKZAVCNFSM6AAAAACCIY3RBGVHI2DSMVQWIX3LMV43ASLTON2WKOZTGI2TSOBSGQYTINA> . You are receiving this because you are subscribed to this thread.Message ID: ***@***.***>

[mingdaoy]

@skrawcz I'd like to help with hosting the docs. Could you walk me through what needs to be done?

We could add a Version dropdown menu here. WDYT?

[skrawcz]

@mingdaoy yes that would be great. We'd just need to figure out how to mark things:

• latest
• which releases to keep around

Then making sure we have SEO links only for the latest versions (I think that's the correct thing to do).

In case it's helpful, right now github workflows builds the docs, and then pushes them to the asf-site (or asf-staging) branch -- see .asf.yaml.