Sample use of this page by an inexperienced beginner[edit source]
@Dave Braunschweig: I will place my notes here. Some of this might be later used to edit this page. But at the moment I lack the understanding to make any changes myself. All is going reasonably well; after about 8 hours and three sessions I have learned enough to make the first entry into this journal:
Getting started[edit source]
My immediate goal is to create a single use public repository where I can push LaTex and Python code for Quizbank documents.
- I am using a WSUL Windows 7 laptop with
gitdisabled as Command prompt. SourceTree employs Windows Explorer, which I never use, and it was necessary for me to upgrade Explorer in order to permit automatic access by SourceTree. After uploading SourceTree I was prompted to first install
Microsoft .Net Framework
- The current SourceTree instructions are slightly out of date. I selected
gitas the version control, made it a public repository (not private) at the beginning. Readers should know that sometimes
Bitbucketis used as a synonym for
Bitbucket Cloud(which is distinct from
Bitbucket Serverthat beginners are not directed to use.)
- I currently use three different web browsers: Explorer is used by SourceTree, which allows one to immediately visit the site. I still use Chrome and am automatically logged into Bitbucket via a Chrome favorite to that site. If I want to view a Bitbucket repository as an outsider I use Mozilla Firefox.
- My first repository was confidently named
quizbankup on Bitbucket, and cloned to my PC under
\User\Documents\quizbank. I realized that I needed to make a long succession of repositories in order to get fluent with all this, giving them "throwaway" names and at the suggestion of the Bitbucket instructions, stored them in a single-use directory for repositories called
repos. At the moment, I am working on my fourth repository called
- One thing that trips you up is conflicting push/pull requests. Also, once I managed to create multiple branches without knowing what brances are. It's best to just delete the repository and start a new one when this happens.
Keeping it simple[edit source]
- I am not certain about this, but I think the push/pull request option is only needed for teams that would check each other's work. If that is correct, then I think I know how to push and pull.
- I also played with snippets, but don't know how much I plan to use them. Snippets are files that can be dragged from a user's desktop without even using SourceTree. Then at a later date, it can be sent down to a local repository where it can be pushed up into a repository. This would be nice because someone could work on any computer with internet access and "drag" a file up to a snippet. But, moving from the snippet to the repository requires a round trip down to a local clone.
- I now have a wiki, something I might not need, but was fun to make.
Suggestion for the WMF regarding a git system[edit source]
- The WMF should sponsor something similar to Bitbucket so that both students and teachers can have private and public wikis.