[Twisted-Python] Post Release updates

[Adi Roiban]

Another thing that is missing from Read The Docs to get feature parity with
current documentation.

If I go to https://docs.twistedmatrix.com/en/twisted-18.4.0/ I don't get
any warning that I am not on the latest stable version.

RTD has something similar... but not quite what we need
[image: image.png]
But I hope that  we can find a way to fix it... but first we need to fix
the "stable" version in RTD


Cheers

On Sun, 28 Feb 2021 at 20:42, Adi Roiban <adi at roiban.ro> wrote:

> Hi,
>
> Happy to see a new version of Twisted released.
> Thanks to anyone for making it happen.
>
> ---------
>
> I think that https://github.com/twisted/twisted/pull/1514 should be
> merged to finalize the release process.
>
> ------
>
> And we have not yet decided if the trunk should be using `.dev` or .post`
> :(
>
> https://twistedmatrix.com/trac/ticket/9542
>
> I am +1 for .post1  ... as it has the semantic of a post release version.
> while .dev0 is a pre-release.
>
> ----------
>
> The https://twistedmatrix.com/documents/current/ documentation was not
> updated.
> But that can be solved after the release.
> I will see if I can update it tonight... and I will check over IRC to see
> if someone else has fixed it.
> First, I am looking at the Read the docs release issues... it looks like
> things are not as automated as we though :D
>
> -------------
>
> I have no idea why the latest tag is not visible on Read the docs
> https://readthedocs.org/projects/twisted/versions/
>
> I have manually activated it based on the f1daeeee tag.
> I went to
> https://readthedocs.org/projects/twisted/versions/?version_filter=twisted-21.2.0
> and then clicked "Activate"
>
> Then I went to https://readthedocs.org/dashboard/twisted/advanced/ and
> select it as "Default" version
> and then click "Save"
>
> Then I went to https://readthedocs.org/projects/twisted/builds/ to check
> the status of the new build.
>
> I see that we now have - https://docs.twistedmatrix.com/en/twisted-21.2.0/
>
> But https://docs.twistedmatrix.com/en/stable/ is still an older build :(
>
> I have no idea why... looks like stable is not active and what is
> origin/8690
>
> [image: image.png]
>
> Maybe Read The Docs is confused by `twisted-21.2.0` as it doesn't look
> like a semantic version .
>
> ----------
>
> Stable was building for
>
> https://github.com/twisted/twisted/commit/99137f53a8a6bd1d8bffa5202373236162daf94e
>
> See RTD stable build
> https://readthedocs.org/projects/twisted/builds/13125823/
>
> So I have wiped the stable version and now it gets 404.
>
> I (or someone else from the team) will have check with Read The Docs team
> to see why we have this issue with the stable version.
>
> ----------
>
> And there are a lot of versions as we have many branches on Twisted.
>
> I guess that at least the branches that were merged, could be removed from
> the main repo.
> I don't see the value for keeping them alive,
>
> That is all for now.
> --
> Adi Roiban
>


-- 
Adi Roiban
-------------- next part --------------
An HTML attachment was scrubbed...
URL: </pipermail/twisted-python/attachments/20210228/a58cb315/attachment-0001.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image.png
Type: image/png
Size: 49779 bytes
Desc: not available
URL: </pipermail/twisted-python/attachments/20210228/a58cb315/attachment-0001.png>