The last major revision of CHT (3.17.0) was released in Oct 2022 and the last minor version (3.17.2) was released a year later in Oct 2023. While Medic has no way to know how many CHT 3.x versions are still running in production, we know that support ended for 3.x almost two full years ago.
With all this in mind, and given we have an archive of 3.x hosting docs already publish on the old docs site, I propose we simplify the docs site by deleting the hosting pages that are for 3.x. Folks may be wondering about the upcoming CHT 5.0 release and if we’ll need a new “CHT 5.x Hosting” section like the 4.x and 3.x that exist today. We will not! Hosting for CHT 4.x and 5.x is identical for both Docker and Kubernetes.
Or, check out the enumerated screenshot showing the current docs site on the left and the proposed on the right:
3.x documentation is removed
All CHT hosting documentation, like “Considerations”, are under the correct and applicable “CHT Core” section
All big and loud callouts about “this applies only to 3.x!!” and the like are removed
Other hosting documentation, like the recently added “couch2pg”, is clearly in it’s own section, a peer of “CHT Core” and not awkwardly a peer of “4.x”
Community feedback is important! If there’s a bunch of concerns suggesting this move is a bad idea, I’ll either amend the changes per the feedback, or cancel them all together. However, if there’s no feedback, or just positive feedback, we’ll look to push these changes by the end of Jul 2025.
Please share your thoughts! Even a thumbs up or thumbs down would be helpful. Thank you!
Thank you @mrjones for reaching out to the community for feedback. We still have a few community supported deployments that are still using 3.x, most of these projects are planning to upgrade soon. I would propose that we remove the 3.x hosting documentation once they have upgraded to 4.x.
@antony - thanks for the input! Would it be acceptable to still delete the content but add a note like this on the main hosting page?
Looking for 3.x Hosting information?
See the old docs site which has a complete copy of hosting 3.x information. Otherwise, the hosting section here includes information for CHT 4.x and later.
That way we can delete it, but folks who still want to read 3.x info can easily find it. At an even later date, we can decide to remove the note and the archive.
Since support for CHT 3.x ended quite a while ago and the old docs are still archived for anyone who needs them, cleaning up the current docs site by removing outdated 3.x hosting pages feels like the right step. I like that you’re not just deleting things but also organizing everything more clearly under a single hosting section with helpful redirects—it’ll make things much easier to navigate for both users and search engines. Thanks for thinking it through so well!
Hi all! I haven’t seen any more updates on this thread. I plan on removing the 3.x hosting docs at the end of the month (or first thing next month if it’s a bit busy for me )
Please do let us know your thoughts if you feel strongly either way about this - thank you!
Hi again! Thanks to a nice review from @diana , the CHT 3.x hosting docs have been removed from the main site. There’s now just 4.x (and 5.x) hosting docs there.
If you need a copy of the 3.x hosting docs, please see the note on that page:
All of the above documentation applies to CHT 4.x and CHT 5.x.
)