Bit Bucket

Bitbucket is a source code management (SCM) system based on the very popular GIT project and has tight integration with many other software development and collaboration tools such as JIRA. Create and manage repositories, set up fine grained permissions and collaborate on code. Bitbucket enables regular code reviews via pull requests to facilitate peer code reviews.

Like most source code management tools, Bitbucket divides its content into “Projects” and within these projects contains one or many “Repositories” also known as a “Repo”.

Project

Projects are the logical segmentation of each application that is being developed. Inside this project contains linked issues, pull requests and any further information that pertains to this project. All of which helps the team keep track of work that needs to be done or being worked on.

Repository

A repository is the main staging area where code is stored. Generally, a repository is the segmentation of each component that comes together and completes a Project. A repository looks very much like a regular file system, the purpose of using a Bitbucket repository is to allow a central location for a team to work on the same project, providing version control, branching, and many features that assist in collaboration of software development. Best practices: Naming convention – Project and repository names should have a standardized naming convention for better searching and organization. If you see an existing convention, follow it or consult the team responsible for that project on what convention they are using.

Access

At the project level, contributor access should only be given to users who need it. All other users should only have read access.

File structure

File structure between different repositories should follow the same convention and basic pattern. This helps various Bitbucket settings such as defining reviewers in a pull request and other automation related tasks.