Talk:Bitbucket/Get Started

Sample use of this page by an inexperienced beginner

@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:

• 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 git 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 Microsoft .Net Framework
2. The current SourceTree instructions are slightly out of date. I selected git as the version control, made it a public repository (not private) at the beginning. Readers should know that sometimes Bitbucket is used as a synonym for Bitbucket Cloud (which is distinct from Bitbucket Server 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 quizbank up 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 \User\repos\fourth
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.