asdf-format/asdf

Retire the "stable" branch

braingram opened this issue · 4 comments

braingram commented

Should we retire the "stable" branch? Our release branches are considered stable so having this branch seems redundant.

@nden @perrygreenfield @eslavich any objection to retiring "stable"?

There are many references to the "stable" documentation that we should consider updating to point to "latest":
https://github.com/search?q=org%3Aspacetelescope+https%3A%2F%2Fasdf.readthedocs.io%2Fen%2Fstable%2F&type=code

nden commented

The only use of the "stable" branch is to generate the "stable" docs as opposed to the "dev" docs. If we are doing this in some other way now, then we don't need it.

braingram commented

Thanks for the clarification. Is it safe to say "stable" should always point to the latest released version?

nden commented

Yes, that was the intention.
I wonder if for the standard it makes sense to have documentation for the various versions. For the library I'd say we need the latest release only and "latest dev".

braingram commented

Thanks! I updated the release docs (with a note about promptly updating the "stable" branch as part of a release to keep the docs up-to-date).