[Twisted-Python] Post Release updates

Adi Roiban adi at roiban.ro
Sun Feb 28 14:39:12 MST 2021


Hi,

https://twistedmatrix.com/documents/current/ is now updated.

It will continue to be the "official" documentation link for this release.

We can add a redirection after getting RTD version up to the same
features... maybe for the next release.

Regards


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

> 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
>


-- 
Adi Roiban
-------------- next part --------------
An HTML attachment was scrubbed...
URL: </pipermail/twisted-python/attachments/20210228/cb80df18/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/cb80df18/attachment-0001.png>


More information about the Twisted-Python mailing list