MAE Training for User July 8, 2013

Agenda Wiki FishEye Crucible Stash

Wiki Based out of Atlassian documentation July 8, 2013

Getting to Know Confluence The Dashboard Page Layout Spaces in Confluence Other users

The Dashboard

Page Layout

Spaces in Confluence What is a Space? ─ Has its own pages, blog posts, comments, RSS feeds and mail (mail applies to site spaces only). ─ Has its own access control settings. You can set different levels of access for different spaces. ─ Can be separately exported to PDF, HTML or XML. The XML export provides a way of backing up and restoring a space. Viewing the spaces in a Confluence site ─ Dashboard ─ Space Directory ─ People Directory

Other Users Viewing people directory. Following people’s activities ─ To start following someone, move your mose over their name or profile picture and choose Follow in their profile popup. ─ To stop following someone, move your mose over their name or profile picture and choose Stop Following in their profile popup.

Personalizing Confluence Updating your user profile Creating your personal space Choosing the homepage you see when you log in Customizing the Dashboard for yourself Getting notifications about changes

Updating User Profile Choose your profile picture at top right of the screen, then choose Profile. Or, choose the Profile link in the sidebar of your personal space Choose Edit Profile. Enter details about yourself in the form displayed. Click Save.

Creating your Personal Space Choose your profile picture at top right of the screen, then choose Add Personal Space. Indicate whether your space should be private or not. A private space will be visible only to you. Choose Create. The homepage of your new space will appear.

Personalizing Confluence Choosing the homepage you see when you log in Customizing the dashboard for yourself Getting notifications about changes

Things to Do Creating Content Adding a space

Create Content / Adding Space

More Helpful Things Keyboard shortcuts Confluence glossary About Confluence

FishEye Based out of Atlassian documentation July 8, 2013

Fisheye Overview Fisheye lets you view the contents of your Source Code Management (SCM) repositories in your web browser. View changesets, revisions, branches, tags, diffs and annotations. Search everything – file names, commit messages, authors, text as well as the source code. Visualize how source changes were introduced, what changed, when it changes, where it was changed, and by who changed it. Track activity in your source code repository.

FishEye Overview (continued) Link specific source with related JIRA issues, Crucible code reviews, and Bamboo builds Get real-time notifications on code activity via , RSS, or OpenSocial dashboards Construct your own sophisticated queries with EyeQL and integrate the results with other tools using the FishEye API.

Header The header along the top of each FishEye page provides the following: The application navigator, at the left of the header, connects you directly to your other applications FishEye logo - click to go to the dashboard, to see your personal code commits, your reviews (if you are using Crucible) and your activity stream. Repositories – the list of all FishEye repositories. Click a repository name to browse the repository.

Header Projects (when using with Crucible) – a link to all projects (see the Crucible documentation). People – tab to view statistics about committers to your FishEye repositories (see Viewing People’s Statistics). Reviews (when using with Crucible) – go to your code reviews (see the Crucible documentation). Click your avatar to change your user settings.

Browsing a repository

Hiding Directories/Files

Watching a repository To watch a repository: -navigate to the repository that you want to watch -Choose Tools > Watch. (the watch icon becomes colored, not grey).

Searching FishEye FishEye has a powerful search engine that allows you to find changesets, committers and files. There are two methods for searching in FishEye: Quick Search — The Quick Search allows you search all repositories connected to FishEye by entering a single search string. Results are weighted by most recent edit date; files edited within the last twelve months are given greater weighting. Advanced Search — The Advanced Search allows you to search a single repository by entering search criteria against a range of fields, e.g. commit comments, file contents, etc. These parameters can be selected on the standard search interface or specified using the FishEye's custom query language: EyeQL. This search is more complex to use, however you can define more precise search criteria.

Quick Search

Advanced Search

Viewing a File

File History

FishEye Charts When browsing a repository, the Reports tab displays graphical information about the lines of code (LOC) committed to the repository, over time. The following options are available: Charts Code Metrics Notes

Chart Types

Code Metrics Commit Time/Volume Top Committers

People Statistics

EyeQL FishEye contains a powerful query language called EyeQL. EyeQL is an intuitive SQL-like language that allows you to write your own specific queries. More information here:

FishEye FAQ FAQs available here:

Crucible Based out of Atlassian documentation July 8, 2013

Crucible Overview Atlassian Crucible is the on-premises code review solution for enterprise teams. It allows your development teams to catch major defects, improve code architecture, or discuss desired improvements, without the need for meetings.

Crucible Dashboard The dashboard is the first screen that you see when you log into FishEye/Crucible. It can be accessed by clicking the FishEye/Crucible icon in the header. ‘My Reviews’ sidebar Using Activity Stream ─ Source Activity ─ Reviews Activity

Crucible Dashboard

Crucible Workflow This page provides an overview of Crucible workflows, followed by a simple example showing a code review between two people. Example workflow: Two participant code review 1. The author starts the review 2. The reviewer comments on the code 3. The author responds to the comments 4. The author closes the review

Workflow Roles Crucible is a flexible application that caters for a wide range of team sizes and work styles. You will need to know about the basic roles used in Crucible: authors: Usually the creator of the code; the person who will act on the review's outcome. reviewer: A participant that will comment on the source files in the review, raising points and discussion on the work that was done. moderator: Usually the person who starts the review and is responsible for deciding the outcomes and closing it. The moderator is disabled for the "agile" permission scheme to simplify workflow.

Creating a Review Within Crucible, create a new review by clicking Create review in the header. Select the project for the review (if you have multiple projects), and click Create Review.

Add Content to the Review In the 'Add Content to Review' dialog, click one of the options to choose files or changesets for review. Crucible supports post-commit and pre-commit review types – these simply depend on the type of content you add to the review:

Edit Review Details Here you can choose a title, reviewers, objectives, due date, linked reviews and issues.

Edit Review Details Once you’re finished, click Done.

Crucible Performance The performance of a Crucible instance can be seriously degraded if very large reviews are created. To prevent a user from accidentally causing this, Crucible has a limit on the review content size when creating reviews. The limit is 800 file revisions.