Git is being used to implement an additional contribution process via a Distributed version control system for the Tiki community. The reasons, pros and cons are documented on Distributed revision control page.
Despite the benefits of using Git, there are many concerns about how each contributor will behave, work and what kind of problems they will find on their daily activities. So, this document and derived pages are an attempt to guess what knowledge a Tiki developer should have for contributing to Tiki.
Git: You are reading this. Root page of the Git structure. An attempt at consolidating/linking all the git information the information. Also a lot of introductory content.
- Using Git with Tiki: Basic instructions on checking out tiki with Git. Status: Recently modified but a lot of obsolete information. Purpose vs Git isn't well documented (I think it was supposed to be a quick start type of page, but unclear).
- Git Usage: A more git task oriented reference, compared to the workflow oriented Git Workflow. Status: Up to date.
- Git concepts for SVN users: Tutorial/cheat sheet for svn users new to git. Definitely useful.
- Git Tips: show some tips on how to do various developer tasks with Git
- Backport changes using Git: Detailed info on a specific git task.
- Merging back changes from a fork: Status: Some information is now incorrect
- Git clone tiki: Status: Brand new page (june 2019). I don't understand why a new page was created vs the larger and more complete Git Usage most of the content is redundant, but in some cases the approach slightly different.
- Git Workflow: The new version control development workflow we will follow from now on. Status: In heavy development.
- Git and SVN combined workflow: Details the workflow behind the current Git and SVN integration. Status: Still up to date
- How to rescue a commit lost from SVN on 2018-04-10: Documentation of a specific svn synchronization problem. Status: Will become obsolete once the git svn workflow is decommissioned
- Git SVN HowTo Documentation of using git-svn command, not to be confused with the Git and SVN combined workflow. Status: obsolete.
- What ToDo When Migrating To Git Documents efforts in migration to Git, considering the whole workflow and release scripts that have to be updated. Status: obsolete. More up to date, status information can now be found on Git
- Distributed revision control Page documenting the rationale for the migration. Status: Probably obsolete.
- Choosing the Git Workflow Migration plan page. Status: probably obsolete
- Best practices for a local Git repository and interacting with the Tiki community: Draft of a workflow. Status: Probably obsolete
Pages in the Git structure we may want to document above (or maybe put the info above in the page description):
- 1 Basic instructions on checking out tiki with Git : Using Git with Tiki
- 2.2 Git clone tiki
- 4.2 Git SVN HowTo
There is a combined workflow using SVN and Git to make a more smooth transition and less impact on daily activities of Tiki developers. This workflow can be found on Git and SVN combined workflow page and it details how is the integration of SVN and Git now.
Also, the current phase of migration strategy involves writing enough documentation and close write access to SVN repository, making it read-only. Probably soon, we will have a Round Table Meeting to check if it is time to close SVN. Only once the following is done can we talk about closing write access to the SVN repo.
- The Git workflow is compelling enough that the majority of developers want to move to it
- All those who would like some support / training have received it.
- The Git-related documentation is ready (we need something equivalent as what we have for SVN)
- The relevant automated scripts (such as the release scripts) have all been ported to use Git
- There is a strategy for usernames (how to request access, etc.)
- Setup workflow to work with Git and SVN
- Write documentation
- Talk on Round Table Meeting about Git
- Setup help channel for developers struggling with Git
- Close SVN write access
- Publish the new Tiki repository
Distributed revision control has discussions which led to Git being the best option.