Skip to content

Commit

Permalink
add circle tool tutorial
Browse files Browse the repository at this point in the history
  • Loading branch information
sasha-astiadi committed May 4, 2023
1 parent 6464453 commit d9ab5b1
Show file tree
Hide file tree
Showing 15 changed files with 107 additions and 0 deletions.
2 changes: 2 additions & 0 deletions src/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -103,5 +103,7 @@
- [Farmerbot](farmerbot/farmerbot.md)
- [ThreeFold Chain](tfchain/tfchain.md)
- [External service contract](tfchain/tfchain_external_service_contract.md)
- [Collaboration Tools](collaboration_tools/collaboration_tools.md)
- [Circle Tool](collaboration_tools/circle_tool.md)
- [How to Contribute](contribute/contribute.md)
- [FAQ](faq/faq.md)
100 changes: 100 additions & 0 deletions src/collaboration_tools/circle_tool.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,100 @@
<h1> ThreeFold's Circle Tool </h1>

<h2>Table of Contents</h2>

- [Introduction](#introduction)
- [Prerequisites](#prerequisites)
- [How to Use the Circle Tool](#how-to-use-the-circle-tool)

***

# Introduction

![ ](../img/taiga.png)

[__ThreeFold's Circle Tool__](https://circles.threefold.me ) is our own self-hosted (desktop only) project management tool based on [Taiga](https://www.taiga.io/), an open-source project management tool for cross-functional agile. It offers a lot of different project management kits and features such as the scrum board, kanban board, issues management, and many more.

Our teams at ThreeFold use the Circle Tool to self-manage our tasks, thus it is deemed necessary for the new onboarded team members to learn how to use the tool. Unfortunately we only provide the desktop version of the tool at this moment since we normally manage our projects on the computer.

This manual will be a beneficial thing to read for anyone: our team members, as well as our community members who are interested in using Circle Tool for their projects.

# Prerequisites

You would need to install and create an account on [TF Connect App](https://manual.grid.tf/getstarted/TF_Connect/TF_Connect.html) before you're able to register and use the Circle Tool.

# How to Use the Circle Tool

* Go to Circle Tool's desktop homepage on: https://circles.threefold.me on your computer / laptop as shown below. Click on '__Login__' button on the very top right corner of your screen.

![ ](../img/circlehome.png)

* Click on "TF Connect" button to log into the Circle Tool by using your TF Connect Account.

![ ](../img/tfconnect.png)

* Fill in your TF Connect usernames (without adding the '@' sign) on the provided box, and click on the 'Sign in' button.

![ ](../img/signin.png)

* Circle Tool will ask you to verify your login by clicking the right emoji that is sent to your TF Connect App.

![ ](../img/emoji.png)

* Verify your sign in process by loggin in to your TF Connect App on your mobile phone. Click on the same emoji that you see on your circle tool (desktop).

![ ](../img/matchemoji.png)

* Congratulations, you are now officially logged in on the circle tool. The Dashboard view will be the first thing you will see once you are logged in to the tool.

![ ](../img/dashboard.png)

***

# Circle Tool Overview

The Circle Tool always try to make things easy and intuitive for new users but it’s good to have a nice & quick overview for your first couple of days.

# Dashboard View

![ ](../img/dashboard.png)

Upon login or if you just go to your Circle Tool, you’re confronted with your dashboard with quick access to your working on items, a list of watched items and shortcuts to your projects. You can always go back to your dashboard by clicking on the Taiga
icon on the top bar.

# Profile view

![ ](../img/profile.png)

Circle Tool has an additional section to get a multiproject view where you can find and list everything that is accessible to you. Simply click on your avatar and you access your personal profile section where you can check from what your personal bio looks like for people that might have access to it to all sorts of information on your activities and relevant content.

# Projects

![ ](../img/project.png)

You can access your assigned projects by clicking on Projects link at the top left of your screen. You can hover and get an interactive shortlist or click on the link and go to a dedicated page where you can access them as well as rearrange them. Once you have clicked on a project, you access your default view for that project, which is always the Project’s Timeline if you haven’t changed that.


# Scrum Module on Project

![ ](../img/homeproject.png)

Every circle project can activate the Scrum module. This also happens automatically if you chose the Scrum template upon project creation. You can find the scrum module on the sidebar of your project page.

Scrum is an agile framework for developing, delivering, and sustaining complex products. Although it had an initial emphasis on software development, it has been used in other fields including research, sales, marketing and advanced technologies.

## Scrum Backlog

![ ](../img/backlog.png)

There are various so called artifacts in Scrum. The top three are the Backlog, the User Stories and the Sprints. They respectively represent what is to be done ordered by priority and readyness, the pieces of work themselves and the fixed time periods in which we put selected User Stories to be worked upon and finished.

## Scrum Sprints

![ ](../img/sprints.png)

The Scrum Backlog view will always show a summary view of ongoing or closed Sprints but teams generally stick to the Sprint Taskboard view when they are focused on getting things done for that Sprint. Click on either the Sprint name or the “Sprint Taskboard” button so you can access the very important Sprint Taskboard. Open Sprints appear as shortcuts through the left navigation pane’s Scrum icon.


# More Info

You can read more about the Circle Tool (Taiga), scrum, sprints, and other documentations on Taiga's project management features on Taiga's official documentation [here](https://community.taiga.io/). Happy Project Managing!
5 changes: 5 additions & 0 deletions src/collaboration_tools/collaboration_tools.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
<h1> ThreeFold's Collaboration Tools </h1>

<h2>Table of Contents</h2>

- [Circle Tool](../circle_tool.md)
Binary file added src/collaboration_tools/img/backlog.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/collaboration_tools/img/circlehome.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/collaboration_tools/img/dashboard.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/collaboration_tools/img/emoji.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/collaboration_tools/img/homeproject.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/collaboration_tools/img/matchemoji.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/collaboration_tools/img/profile.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/collaboration_tools/img/project.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/collaboration_tools/img/signin.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/collaboration_tools/img/sprints.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/collaboration_tools/img/taiga.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/collaboration_tools/img/tfconnect.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit d9ab5b1

Please sign in to comment.