Difference between revisions of "Infrastructure Team/Migrating to GitHub"

Revision as of 13:03, 17 May 2016

Sugar Activities Developers: Take 10 Minutes to move to Github Today!

Part of the vision of Sugar Labs is to introduce young people to the software freedom movement. A successful introduction means they are actively participating in Sugar's development, and the wider libre software world. The majority of libre software in 2016 is developed on Github, and it advances our cause to use the same collaboration platform as most other project use.

The Sugar codebase has begun transitioning to Github in www.github.com/sugarlabs. So we now invite all Activity developers to do 2 things to complete this transition.

This should take you no more than 10 minutes:

1. Migrate your project source code and issue tracking to Github (https://help.github.com/articles/create-a-repo)

2. Once your project is set up as a Github Repo, please transfer it to github.com/sugarlabs so it is more discoverable (https://help.github.com/articles/transferring-a-repository/)

After the transfer, we'll update the activity.info file of the activity itself with the new URL We'll also invite your Github username to join the github.com/sugarlabs organization, so you can transfer activities to yourself.

No longer involved? To pass your Activity on to the community to maintain, drop a line to <sugar-devel@lists.sugarlabs.org>. If you read this well after May 2016, we may have already forked your repo into the org to maintain an 'official' copy of it, but transferring is better than forking so that Github shows the sugarlabs repo as the 'upstream' repo on network graph pages (example)

New to Github? Check their excellent documentation at guides.github.com, help.github.com, try.github.io

Details

All our code, bugs and discussions should be in one place.

In 2013 Sugar's core components moved from http://git.sugarlabs.org/sugar-old to https://github.com/sugarlabs/sugar, but all issue tracking stayed at bugs.sugarlabs.org instead of moving to https://github.com/sugarlabs/sugar/issues and some code stayed in git.sugarlabs.org and some moved to personal Github username areas.

This scattering

deters new contributors;
makes existing contributor's lives more painful;
wastes time from our systems team volunteers (as we have a hard time keeping hackers out of trac, and need to spend time upgrading any service we run ourselves)

Two solutions have been proposed:

1. Consolidate on Github: Set trac and gitorious read only, and then making it a static html archive, while moving all issue tracking and git hosting of each sugar repo to Github.

2. Abandon Github: Consolidate on our own systems; I guess this means setting up gogs or gitlab to replace gitorious, and perhaps something else to replace trac, and then removing each sugar repo from Github that we control, and regularly encouraging all sugar activities on github to move to our infrastructure.

The developer community has discussed this (thread) and reached consensus in favour of (1) with the following comments:

Benefits of Github Consolidation

Notification: This is handled due to the way that Github org membership works. Github-users in a 'developers' Github-team within the Github-organization will be emailed all posts to all repos that are added to that team (done here, http://imgur.com/gUTNFfV)

Search: Github provides org-wide search, and this is discoverable when you visit github.com/sugarlabs the search input widget at the top changes to show that the search is scoped to that organization. After entering a search query, a familiar search syntax is used in the query, and in the URL string. Eg, https://github.com/search?q=org%3Afontforge+x11&type=Issues

Discoverability: It will be easier for new developers to find and contribute if Sugar is all on github.

Github allows us to separate issue into separate Sugar and Sugar Activity trackers, trackers are found predictably at github.com/sugarlabs/activity-name/issues
It serves as an issue aggregation tool, as all issue trackers in the github.com can be searched by visiting github.com/sugarlabs and using the search input at the very top of the page (example)
https://github.com/sugarlabs/sugar/issues/ can be used as a default issue tracker, if there is any ambiguity on where to file an issue
Issues on Github can be linked to pull requests that resolve them (and even close them automatically by including "closes #issue_id" in the commit/pr message)
Github automatically places backlinks in issues that are referred to by other issuer or PRs, it is relatively convenient to manage the set of a github organization's per-repo issue trackers. Github makes this easy because it will add backlinks in the destination issue's timeline when that issue is mentioned in the original; and it will automatically create such links if you type user/repo#issueNumber :) As an example of this back-linking, see these 2 links, https://github.com/llaske/sugarizer/issues/49 (link at end of first post) and https://github.com/mattlag/Glyphr-Studio/issues/234 (currently link is at the bottom :)

Focus: SugarLabs should focus on core-competencies. Managing version control servers shouldn't be one of them. Support for "how to use git" would be mostly on github rather than SugarLab's systems

Developer Preference: Getting existing Github users to move their activities out of Github doesn't seem realistic. Developers know that Github is stable and has security and longevity. People new to Github have a wider interest in signing up for it - because almost all other libre software projects that they will interact with are currently on the service.

Viability: There are only 182 open issues on bugs.sugarlabs.org so moving them over can be done in a day

Automation: Github enables easier automation of the release process, and easier tying of Sugar Activity version numbers to moments in git commit histories.

Fully Featured: Github doesn't exclude users from features based on their ability to pay; all features are available to non-paying users. Instead of charging for features, they require non-paying users to have all their repos be public; the only thing that they charge for is how many users can participate in private repos. https://github.com/pricing/plans explains this, and there are no gotchas.

Pseudonymity: Github does not require real names. To maintain pseudonymity, you can sign up using http://mailinator.com or a github-specific disposable email account.

Further Actions For The Sugar Labs Team

Set up a "full notifications" team in the github organization so that all github users that join this team get emailed every issue, pr, and comment for every github project within the organization.

Configure all non-github issue trackers to prominently direct users to the new github url, and disallow new issues, or simply to have their theme templates hide the 'new issue' link, and eventually to be configured read only and then fully archived by conversion to a static HTML site.

Review the wiki and website advising users where to post an issue, and update to point to Github

Write a py/js script that uses the Github API to check issue tags are consistent across all SL repos; this can start with a manual checklist to run through when accepting a repo transfer to the sugarlabs org. Also, ensure each activity's /README.md file (that Github presents on github.com/sugarlabs/activity-name as processed markdown) has explicit information about standard things, like where its issue tracker is.

Once all activities are migrated to Github, set the Gitorious and Trac instances to be read-only.

List of Existing Repos To Transfer

On 2016-05-16 https://github.com/search?l=&q=%22from+sugar3.activity+import+activity%22+language%3APython&ref=advsearch&type=Code&utf8=%E2%9C%93 shows 327 code results, which when scraped and deduplicated lists 202 repos that are python sugar activities:

@@ Line 81: / Line 81: @@
 * Once all activities are migrated to Github, set the Gitorious and Trac instances to be read-only.
+== List of Existing Repos To Transfer ==
+On 2016-05-16 https://github.com/search?l=&q=%22from+sugar3.activity+import+activity%22+language%3APython&ref=advsearch&type=Code&utf8=%E2%9C%93 shows 327 code results, which when scraped and deduplicated lists 202 repos that are python sugar activities:
+[https://github.com/AbrahmAB/sugar-toolkit-gtk3-proto AbrahmAB/sugar-toolkit-gtk3-proto]
+[https://github.com/Boquete/activity-labyrinth Boquete/activity-labyrinth]
+[https://github.com/Boquete/activity-sliderpuzzle Boquete/activity-sliderpuzzle]
+[https://github.com/City-busz/city-repository City-busz/city-repository]
+[https://github.com/Daksh/CeibalRadio Daksh/CeibalRadio]
+[https://github.com/Daksh/poll Daksh/poll]
+[https://github.com/FOSSRIT/Sash FOSSRIT/Sash]
+[https://github.com/FundacionZamoraTeran/Genios FundacionZamoraTeran/Genios]
+[https://github.com/FundacionZamoraTeran/Megamente FundacionZamoraTeran/Megamente]
+[https://github.com/Grumbel/clockgr Grumbel/clockgr]
+[https://github.com/Richardopy/cuadradomagico Richardopy/cuadradomagico]
+[https://github.com/ShivamNegi/Reflections_Activity ShivamNegi/Reflections_Activity]
+[https://github.com/activitycentral/ebookreader activitycentral/ebookreader]
+[https://github.com/aguzubiaga/chart aguzubiaga/chart]
+[https://github.com/ceibal-tatu/ceibal-notifica ceibal-tatu/ceibal-notifica]
+[https://github.com/ceibal-tatu/fototoon-activity ceibal-tatu/fototoon-activity]
+[https://github.com/ceibal-tatu/sugar-toolkit-gtk3 ceibal-tatu/sugar-toolkit-gtk3]
+[https://github.com/cristhofert/presentation cristhofert/presentation]
+[https://github.com/cristian99garcia/ClockActivity cristian99garcia/ClockActivity]
+[https://github.com/cristian99garcia/PolariActivity cristian99garcia/PolariActivity]
+[https://github.com/cristian99garcia/agubrowser-activity cristian99garcia/agubrowser-activity]
+[https://github.com/cristian99garcia/blender-activity cristian99garcia/blender-activity]
+[https://github.com/cristian99garcia/calculator cristian99garcia/calculator]
+[https://github.com/cristian99garcia/cedit-activity cristian99garcia/cedit-activity]
+[https://github.com/cristian99garcia/collabedit cristian99garcia/collabedit]
+[https://github.com/cristian99garcia/dasher-activity cristian99garcia/dasher-activity]
+[https://github.com/cristian99garcia/devtutor-activity cristian99garcia/devtutor-activity]
+[https://github.com/cristian99garcia/guido-van-robot-activity cristian99garcia/guido-van-robot-activity]
+[https://github.com/cristian99garcia/laybrinth-activity cristian99garcia/laybrinth-activity]
+[https://github.com/cristian99garcia/mapa-ceibal-activity cristian99garcia/mapa-ceibal-activity]
+[https://github.com/cristian99garcia/maps-activity cristian99garcia/maps-activity]
+[https://github.com/cristian99garcia/micropolis-activity cristian99garcia/micropolis-activity]
+[https://github.com/cristian99garcia/pilas-activity cristian99garcia/pilas-activity]
+[https://github.com/cristian99garcia/pocket-lrad-activity cristian99garcia/pocket-lrad-activity]
+[https://github.com/cristian99garcia/poll-activity cristian99garcia/poll-activity]
+[https://github.com/cristian99garcia/pydebug-activity cristian99garcia/pydebug-activity]
+[https://github.com/cristian99garcia/riverhex-activity cristian99garcia/riverhex-activity]
+[https://github.com/cristian99garcia/showntell-activity cristian99garcia/showntell-activity]
+[https://github.com/cristian99garcia/sugarcity-activity cristian99garcia/sugarcity-activity]
+[https://github.com/cristian99garcia/teachteacher-activity cristian99garcia/teachteacher-activity]
+[https://github.com/cristian99garcia/turtleart cristian99garcia/turtleart]
+[https://github.com/cristian99garcia/tuxmath-activity cristian99garcia/tuxmath-activity]
+[https://github.com/crusher95/webconfusion crusher95/webconfusion]
+[https://github.com/curiousguy13/sugar-python3-tests curiousguy13/sugar-python3-tests]
+[https://github.com/cygwinports-extras/sugar-HelloWorld cygwinports-extras/sugar-HelloWorld]
+[https://github.com/erik/translate-activity erik/translate-activity]
+[https://github.com/erilyth/Hello-World-Python_Sugar erilyth/Hello-World-Python_Sugar]
+[https://github.com/erilyth/Simon_Says-Sugar erilyth/Simon_Says-Sugar]
+[https://github.com/erilyth/Sugarizer-Clone-Sugarlabs- erilyth/Sugarizer-Clone-Sugarlabs-]
+[https://github.com/ers-devs/contact-app ers-devs/contact-app]
+[https://github.com/ezequielpereira/Constellationsflashcards ezequielpereira/Constellationsflashcards]
+[https://github.com/ezequielpereira/Edit ezequielpereira/Edit]
+[https://github.com/ezequielpereira/Gmail ezequielpereira/Gmail]
+[https://github.com/ezequielpereira/HacketyHack ezequielpereira/HacketyHack]
+[https://github.com/ezequielpereira/JClic ezequielpereira/JClic]
+[https://github.com/ezequielpereira/Java ezequielpereira/Java]
+[https://github.com/ezequielpereira/Kiwix ezequielpereira/Kiwix]
+[https://github.com/ezequielpereira/Lemonade ezequielpereira/Lemonade]
+[https://github.com/ezequielpereira/MathGraph32 ezequielpereira/MathGraph32]
+[https://github.com/ezequielpereira/ShowJPEG ezequielpereira/ShowJPEG]
+[https://github.com/ezequielpereira/Snow ezequielpereira/Snow]
+[https://github.com/ezequielpereira/Sugarizador ezequielpereira/Sugarizador]
+[https://github.com/ezequielpereira/Sugarizehelp ezequielpereira/Sugarizehelp]
+[https://github.com/ezequielpereira/Time-Line ezequielpereira/Time-Line]
+[https://github.com/ezequielpereira/VncLauncher ezequielpereira/VncLauncher]
+[https://github.com/ezequielpereira/XOlympics ezequielpereira/XOlympics]
+[https://github.com/ezequielpereira/XaoS ezequielpereira/XaoS]
+[https://github.com/ezequielpereira/cavestory ezequielpereira/cavestory]
+[https://github.com/fdanesse/DesafioMundial fdanesse/DesafioMundial]
+[https://github.com/fdanesse/Historico fdanesse/Historico]
+[https://github.com/fdanesse/JAMediaPyGiHack fdanesse/JAMediaPyGiHack]
+[https://github.com/fdanesse/TamTamMini fdanesse/TamTamMini]
+[https://github.com/georgejhunt/HaitiDictionary.activity georgejhunt/HaitiDictionary.activity]
+[https://github.com/godiard/classroomexplore godiard/classroomexplore]
+[https://github.com/godiard/clock-activity godiard/clock-activity]
+[https://github.com/godiard/comunicator-maker-activity godiard/comunicator-maker-activity]
+[https://github.com/godiard/develop-activity godiard/develop-activity]
+[https://github.com/godiard/distance-activity godiard/distance-activity]
+[https://github.com/godiard/domino-activity godiard/domino-activity]
+[https://github.com/godiard/favorite-fonts-activity godiard/favorite-fonts-activity]
+[https://github.com/godiard/finance-activity godiard/finance-activity]
+[https://github.com/godiard/fototoon-activity godiard/fototoon-activity]
+[https://github.com/godiard/get-books-activity godiard/get-books-activity]
+[https://github.com/godiard/help-activity godiard/help-activity]
+[https://github.com/godiard/imageviewer-activity godiard/imageviewer-activity]
+[https://github.com/godiard/ingenium-activity godiard/ingenium-activity]
+[https://github.com/godiard/irc-activity godiard/irc-activity]
+[https://github.com/godiard/journalshare-activity godiard/journalshare-activity]
+[https://github.com/godiard/jukebox-activity godiard/jukebox-activity]
+[https://github.com/godiard/level-activity godiard/level-activity]
+[https://github.com/godiard/log-activity godiard/log-activity]
+[https://github.com/godiard/maze-activity godiard/maze-activity]
+[https://github.com/godiard/memorize-activity godiard/memorize-activity]
+[https://github.com/godiard/music-keyboard-activity godiard/music-keyboard-activity]
+[https://github.com/godiard/paint-activity godiard/paint-activity]
+[https://github.com/godiard/poll-activity godiard/poll-activity]
+[https://github.com/godiard/read-activity godiard/read-activity]
+[https://github.com/godiard/tamtam godiard/tamtam]
+[https://github.com/godiard/terminal-activity godiard/terminal-activity]
+[https://github.com/godiard/words-activity godiard/words-activity]
+[https://github.com/godiard/write-activity godiard/write-activity]
+[https://github.com/godiard/write-books-activity godiard/write-books-activity]
+[https://github.com/gusDuarte/sugar-toolkit-gtk3 gusDuarte/sugar-toolkit-gtk3]
+[https://github.com/i5o/followme i5o/followme]
+[https://github.com/i5o/getbooks i5o/getbooks]
+[https://github.com/i5o/install-extensions i5o/install-extensions]
+[https://github.com/i5o/irc-activity i5o/irc-activity]
+[https://github.com/i5o/letters i5o/letters]
+[https://github.com/i5o/log i5o/log]
+[https://github.com/i5o/manage-homeviews i5o/manage-homeviews]
+[https://github.com/i5o/numbers i5o/numbers]
+[https://github.com/i5o/qr-reader i5o/qr-reader]
+[https://github.com/i5o/record-gtk3 i5o/record-gtk3]
+[https://github.com/i5o/spirolaterals i5o/spirolaterals]
+[https://github.com/i5o/sugar-irc-client i5o/sugar-irc-client]
+[https://github.com/i5o/triples i5o/triples]
+[https://github.com/i5o/whatis i5o/whatis]
+[https://github.com/i5o/xo-icon i5o/xo-icon]
+[https://github.com/i5o/xo-retroscope i5o/xo-retroscope]
+[https://github.com/iamutkarshtiwari/Browse-fiddleFeature iamutkarshtiwari/Browse-fiddleFeature]
+[https://github.com/inkyfingers/SoaS_Loader inkyfingers/SoaS_Loader]
+[https://github.com/jdsimmons/getiabooks jdsimmons/getiabooks]
+[https://github.com/jdsimmons/myosa-examples jdsimmons/myosa-examples]
+[https://github.com/jdsimmons/readetexts jdsimmons/readetexts]
+[https://github.com/jdsimmons/sugar-commander jdsimmons/sugar-commander]
+[https://github.com/jdsimmons/viewslides jdsimmons/viewslides]
+[https://github.com/kperisetla/Oopsy kperisetla/Oopsy]
+[https://github.com/lesivan/Genios lesivan/Genios]
+[https://github.com/llaske/Canope.activity llaske/Canope.activity]
+[https://github.com/llaske/KAView.activity llaske/KAView.activity]
+[https://github.com/llaske/VideoViewer.activity llaske/VideoViewer.activity]
+[https://github.com/llaske/sugarizer llaske/sugarizer]
+[https://github.com/manuq/get-books manuq/get-books]
+[https://github.com/manuq/hello-world manuq/hello-world]
+[https://github.com/manuq/instalador-harvest-ceibal manuq/instalador-harvest-ceibal]
+[https://github.com/manuq/sugar-toolkit-gtk3 manuq/sugar-toolkit-gtk3]
+[https://github.com/native93/Sugar-paint-activity native93/Sugar-paint-activity]
+[https://github.com/ndefilippis/level-tool ndefilippis/level-tool]
+[https://github.com/prasoon2211/sugar-social-help prasoon2211/sugar-social-help]
+[https://github.com/puneetgkaur/backup_sugar_sugartoolkit puneetgkaur/backup_sugar_sugartoolkit]
+[https://github.com/puneetgkaur/pygame_camera puneetgkaur/pygame_camera]
+[https://github.com/quozl/settime-activity quozl/settime-activity]
+[https://github.com/richaseh/browse richaseh/browse]
+[https://github.com/samdroid-apps/bibliography-activity samdroid-apps/bibliography-activity]
+[https://github.com/samdroid-apps/browse samdroid-apps/browse]
+[https://github.com/samdroid-apps/sour-textbook samdroid-apps/sour-textbook]
+[https://github.com/samdroid-apps/web-maker-activity samdroid-apps/web-maker-activity]
+[https://github.com/sdanielf/comunicate sdanielf/comunicate]
+[https://github.com/sehgalvibhor/WebConfusion sehgalvibhor/WebConfusion]
+[https://github.com/sethwoodworth/tamtam sethwoodworth/tamtam]
+[https://github.com/shlesha/My-Activities shlesha/My-Activities]
+[https://github.com/shridharmishra4/mainline shridharmishra4/mainline]
+[https://github.com/shridharmishra4/tamtam shridharmishra4/tamtam]
+[https://github.com/sugarlabs/browse-activity sugarlabs/browse-activity]
+[https://github.com/sugarlabs/sugar-toolkit-gtk3 sugarlabs/sugar-toolkit-gtk3]
+[https://github.com/svineet/Solari svineet/Solari]
+[https://github.com/svineet/manage-homeviews svineet/manage-homeviews]
+[https://github.com/tchx84/ClockActivity tchx84/ClockActivity]
+[https://github.com/tchx84/comunicator-maker-activity tchx84/comunicator-maker-activity]
+[https://github.com/tchx84/debian-pkg-sugar-toolkit-gtk3 tchx84/debian-pkg-sugar-toolkit-gtk3]
+[https://github.com/tchx84/get-books-activity tchx84/get-books-activity]
+[https://github.com/tchx84/memorize-activity tchx84/memorize-activity]
+[https://github.com/tchx84/sugar-finance-activity tchx84/sugar-finance-activity]
+[https://github.com/tchx84/sugar-toolkit-gtk3-1 tchx84/sugar-toolkit-gtk3-1]
+[https://github.com/walterbender/AEIOU walterbender/AEIOU]
+[https://github.com/walterbender/Pippy walterbender/Pippy]
+[https://github.com/walterbender/abacus walterbender/abacus]
+[https://github.com/walterbender/cardsort walterbender/cardsort]
+[https://github.com/walterbender/chat walterbender/chat]
+[https://github.com/walterbender/clipart walterbender/clipart]
+[https://github.com/walterbender/colordeducto walterbender/colordeducto]
+[https://github.com/walterbender/convert walterbender/convert]
+[https://github.com/walterbender/cookiesearch walterbender/cookiesearch]
+[https://github.com/walterbender/dimensions walterbender/dimensions]
+[https://github.com/walterbender/flip walterbender/flip]
+[https://github.com/walterbender/fractionbounce walterbender/fractionbounce]
+[https://github.com/walterbender/iknowmyabcs walterbender/iknowmyabcs]
+[https://github.com/walterbender/infoslicer walterbender/infoslicer]
+[https://github.com/walterbender/lettermatch walterbender/lettermatch]
+[https://github.com/walterbender/letters walterbender/letters]
+[https://github.com/walterbender/locosugar walterbender/locosugar]
+[https://github.com/walterbender/makeymakey walterbender/makeymakey]
+[https://github.com/walterbender/napier walterbender/napier]
+[https://github.com/walterbender/nutrition walterbender/nutrition]
+[https://github.com/walterbender/paths walterbender/paths]
+[https://github.com/walterbender/physics walterbender/physics]
+[https://github.com/walterbender/portfolio walterbender/portfolio]
+[https://github.com/walterbender/primedimensions walterbender/primedimensions]
+[https://github.com/walterbender/recall walterbender/recall]
+[https://github.com/walterbender/reflect walterbender/reflect]
+[https://github.com/walterbender/reflection walterbender/reflection]
+[https://github.com/walterbender/ruler walterbender/ruler]
+[https://github.com/walterbender/slideruler walterbender/slideruler]
+[https://github.com/walterbender/story walterbender/story]
+[https://github.com/walterbender/storydos walterbender/storydos]
+[https://github.com/walterbender/sugarchess walterbender/sugarchess]
+[https://github.com/walterbender/training walterbender/training]
+[https://github.com/walterbender/turtlepond walterbender/turtlepond]
+[https://github.com/walterbender/wordcloud walterbender/wordcloud]
+[https://github.com/walterbender/worddimensions walterbender/worddimensions]
+[https://github.com/walterbender/xocolors walterbender/xocolors]
+[https://github.com/walterbender/yupana walterbender/yupana]