Manual Solving Pull-Request Conflicts

There are instances where a DCS github user submits a Pull-Request from their Fork of the repository which cannot be Merged automatically. The steps below will identify one approach for a repository administrator to solve this problem.

This approach requires that that administrator have a local, PC-based, repository of the project which is linked to their Forked repository, which is, by definition, linked to the main repository of the project. This discussion covers a local repository on a Windows PC. The discussion below assumes that the user and main project are on the “master” branch.

  1. Have that user commit any changes that have yet to be committed to their fork. Have them provide you a list of all of the changed files that have been committed to their Fork since their last successful Pull-Request.
  2. Direct that user to make no further edits until they are directed to do so.
  3. Open that user’s Fork, https://git.door43.org/< User’s DCS id>/<project id>/src/branch/master/
  4. Click the Download button on the right of the web page and select ZIP and the system will create a zip file in your  PC’s Downloads folder (or wherever you have Windows configured to store downloads) with the name “<project id>-master.zip”
  5. Create a new folder specifically for the user’s files, but not under one of your local git repository folders.
  6. Back on the main DCS web page for that project, https://git.door43.org/unfoldingWord/<project id> or https://git.door43.org/WycliffeAssociates/<project id> you, as administrator, will move to the problematic Pull-Request and select “Close” to close it to any future action.
  7. On your PC side of things, move to your project’s local git repository and do the following sub-steps:
    1. Enter ‘git pull origin master’ to ensure that you have the latest files from the main repository in your local repository.
    2. For any changed files that you have made to the project which have not been pushed up to the main repository, do the associated git adds, git commit, git push {use “git push origin master”) to get your changes installed in the project’s repository without the need of a Pull-Request.
    3. Copy all changed files identified by that user from the extracted folders into appropriate folders of your local git repository.
    4. Perform the ‘git add’ for each of those, then the ‘git commit -m “message describing the changes”’, and then the ‘git push origin master’.
  8. Direct the user to delete their forked repository since it had an invalid configuration of files, and now does not have those that you just merged. They should follow the sub-steps below:
    1. Have them log on and open their forked repository on the DCS web.
    2. Have them select the Setting icon on the right side of the web page and on the Options tab scroll down to the Danger Zone.
    3. Have them select the “Delete This Repository’ button and then on the pop-up menu type the projects name, as identified on that web page. Lastly, select the “Confirm Deletion” button.
    4. Have the user open the project’s main repository page, see F. above and select the “Fork” icon near the top and right, , and then on that pop-up ‘New Repository Fork’ window select the ‘Fork Repository’ button at the bottom, leaving all of the fields unchanged.
  9. The user is now configured to begin their editing again.

MAST technician job description and what to expect.

A MAST technician will encounter a wide range of issues on a MAST. The nature of the issues will be both technical and social. Having impeccable technical skills will only get you part of the way there. You should also be aware that you will need the so-called “soft...

Post MAST-TSP Workshop

Hello all, As we are developing the materials and support that we all need. Would you please add a post here of those things that you would like to have or need to know where it is? For instance - here are the websites that will be good to remember:...

Installing MAST Apps on a tablet

Here is a video on how I install apps...not just any apps....but MAST specific apps on atablet.  I know....sounds exciting!  Well, actually it is.  The work that translators do on these tablets is life changing.  Along with the video, I have added tablet specs and an...

How to Get Help

John explains the different tools used for technical support for Bible Translation.  Email is probably the best type of support.  Just send a helpdesk ticket to [email protected]       https://www.youtube.com/watch?v=mphZwBbiuuU   Some...

Changing Server Settings

Here is documentation on how to set the WACS server up in tStudio Android. I’m thinking that this will become a popular question. Server Settings Keep the settings for the server as determined by the program. There is no need to edit any of the settings unless...

Android Install

The following apps are recommended to install and place on the front pane of an Android tablet for written and oral translation projects.  The tech only items should not appear on pane display.  

Installing SyncThing on a Windows 10 computer

Follow these simple instructions on installing SyncThing on a Windows 10 machine for MAST data collection. Notes: Install SyncTrazor

How to migrate or clone a repo on door43 to WACS

How to migrate or clone a repo on Door43 to WACS. Compare mirror and non-mirror options.

How to format Translation Notes for publishing (V-MAST)

In V-MAST, translators are given free rein to reformat the content. However, they should not reformat content destined to be published as source text. This article specifies the expected content format. Note that BTT Writer does its own formatting when translating tN,...

How to Prepare tS Translation Notes Projects for Publishing

Note: This article is one in a series of articles describing how to get a GL project ready to publish so that others can benefit from it. This article deals with Translation Notes (tN) projects created in translationStudio. A complete Bible tN project consists of...