I have a double sided question and a regular question. If I submit a PR to branch-2.4, will the documentation be updated automatically, or would a release be needed? If a release were needed, would you consider doing that?
Are there any similar changes to look out for? I wasn’t able to find any 3.0 changelog. I wasn’t able to find any documentation for 3.0.0.dev2 even though it’s available on PyPI as a pre-release.
I think it would be very helpful as I was very confused as to why source stopped being necessary only to eventually discover it was never necessary yet is used in the examples.
Hi @OriolAbril we publish “dev” build primarily for the Bokeh dev team to use for testing, and for downstream projects (e.g. Dask, Panel, Holoviews, etc.) to test against. We do not really encourage regular users to use them, so we don’t publicize dev docs either. We do publish dev docs, but only for the latest dev release on each release branch, not for every dev release. You can find the 3.0 dev docs here:
One we reason we do not encourage regular users to use “dev” builds is that we do not guarantee that CDN resources for dev builds will be permanently available. For this reason, you shold never, ever rely on a dev build "in production".
If a release were needed, would you consider doing that?
Between minor releases, we can generally issue point releases easily any time. But things get a bit more difficult in front of a major release as the branches tend to diverge more. We are getting ready for a new major release that is still at least a months away. We would probably only bother with a 2.4.3 release for a very major bugfix at this point.
However, in this case, the change for source is only for 3.0+ so a fix for the docs should only go against branch-3.0 for the future 3.0 release, and not against branch-2.4. The current latest docs are correct for the current latest release (2.4.2).
Docs are generally updated as part of a feature PR, but it looks like this example was possibly missed, so a PR (against branch-3.0) would be appropriate and welcome. The change would show in the dev-3.0 docs whenever the next 3.0 dev build is released. (We don’t have any set schedule for those, they are made periodically as-needed.)
For many years there was only the “dev” URL, because there was only one line of development. The dev-x.0 URLs are only recent, after we started keeping longer running branch-x.0 branches for parallel development. The URLs will always be dev-x.0 for corresponding branch-x.0, but probably only start with 2.4 IIRC.
search for 3.0 changelog but not be able to find it
Bad habits maybe, but we usually only make cursory changelog updates while development is in flight. There is always a dedicated PR right before a release to clean up or flesh out the release guide guide. There’s been some discussion about being more proactive and also including an Unreleased release notes section, but it’s not work anyone has decided to dedicate their time to as of yet.