Mailman 3 June 2022 - Twisted

Migration of Trac Ticket to GitHub Issues
by Adi Roiban June 28, 2022

June 28, 2022

Hi, FYI, the process of migrating Trac Tickets to GitHub Issue has started. We expect to have the migration ready by tomorrow 28 of June 2022 at 13:00 UTC. Please don't create any PR or issues to the https://github.com/twisted/twisted repo. I will send an update over here when the migration is done. Thanks! -- Adi Roiban

2 2

Trac Wiki migration / archive
by Adi Roiban June 28, 2022

June 28, 2022

Hi, As part of the general effort to decommission our Trac website I have archived the wiki at the following repo https://github.com/twisted/trac-wiki-archive The plan is to mark the repo as "Archive" Any changes should be done in the twisted/twisted documentation or in the twisted.github.io website repo. The name of the repo can be renamed. Feel free to suggest better names or a better README file. ------- After we decommission the Trac instance we will implement a redirection for /trac/wiki/PAGE to a file on the archived GitHub repo. ------- There are already 2 PR https://github.com/twisted/twisted.github.io/pulls to migrate the wiki to Pelican or to Sphinx Feedback and a review is welcomed. Instead of a bulk conversion, my preference is for improving the "official"' Twisted documentation at https://docs.twistedmatrix.com/ with any valuable info from the wiki. Any non-documentation content should be converted into simple web pages for https://twisted.org/ ----------- Comments, questions ? Regards -- Adi Roiban

2 2

Preparing the migration from Trac tickets to GitHub Issues
by Adi Roiban June 20, 2022

June 20, 2022

Hi, In preparation for the Trac ticket migration to GitHub Issues a staging/testing repository was created You can find the list of migrated issues here https://github.com/twisted/twisted-trac-migration/issues Send any feedback at the following ticket and my colleague Dan will try to address all the comments: https://github.com/twisted/twisted-trac-migration/issues/1 A bit of hard work is left to find the mapping between Trac users and GitHub users Handling at: https://github.com/twisted/twisted-trac-migration/issues/2 -------------- Once the migration starts, Trac will be in read-only mode with a message on the Trac wiki start page. The plan is to keep it only in read mode for a few more days until redirections are implemented. We still need to see how to put the GitHub twisted/twisted repo in a protected mode during the migration. One option to temporarily rename the main branch as "DONT-CREATE-A-PR-YET" and have a new PR template that will explain that people should wait 1 day for the migration to be finalized. Suggestions are welcomed for how to do the migration. Making the repo private is not an option. The followers/starts will be lost, and repo owners can still create PRs. ---------------- There is a list of issues with ID from 1 to 1732 So Trac ID 1 was migrated as https://github.com/twisted/twisted-trac-migration/issues/11323 Trac tickets with IDs 1733 or greater have a direct mapping. So Trac with ID 1733 is https://github.com/twisted/twisted-trac-migration/issues/1733 ---------- The migration will take about 1 day. This is slow as GitHub API is throttling the requests. The high-level plan targeting 4-5 June for going live: * Gather feedback in the next days and implement the required changes. * Next Monday, 30rd of May, re-run a full import for testing * By next Wednesday, the 1st of June, the testing import should be ready * Review the full migration and see if this is ready for going live. * Wait for feedback until Friday 3 of June. * If there are no complaints, the final / PROD migration will be triggered over the 4-5 June weekend. ----------------- Below are some examples. # Reopened, enhancement, link to another ticket https://github.com/twisted/twisted-trac-migration/issues/3621 # Reopened, attachment https://github.com/twisted/twisted-trac-migration/issues/4258 # a lot of changes and attachments https://github.com/twisted/twisted-trac-migration/issues/4536 # Enhancement, second comment replies to different ticket https://github.com/twisted/twisted-trac-migration/issues/6887 # Reopened -> new https://github.com/twisted/twisted-trac-migration/issues/9300 # Reopened -> closed, milestone, code example https://github.com/twisted/twisted-trac-migration/issues/9335 # With assigned team member, enhancement, new milestone, fixed https://github.com/twisted/twisted-trac-migration/issues/10027 Thanks -- Adi Roiban

4 10