Talk:Bitbucket/Get Started

Sample use of this page by an inexperienced beginner
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:


 * See also https://bitbucket.org/Guy_vandegrift/
 * https://bitbucket.org/Guy_vandegrift/qbwiki/wiki/Home
 * https://bitbucket.org/Guy_vandegrift/qbwiki/src/master/

Getting started
My immediate goal is to create a single use public repository where I can push LaTex and Python code for Quizbank documents.
 * 1) I am using a WSUL Windows 7 laptop with  disabled 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
 * 2) The current SourceTree instructions are slightly out of date. I selected   as the version control, made it a public repository (not private) at the beginning.  Readers should know that sometimes   is used as a synonym for   (which is distinct from    that beginners are not directed to use.)
 * 3) 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.
 * 4) My first repository was confidently named  up on Bitbucket, and cloned to my PC under  .  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  .  At the moment, I am working on my fourth repository called
 * 5) 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

 * 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

 * The WMF should sponsor something similar to Bitbucket so that both students and teachers can have private and public wikis.