Company management - Documentation - Riter

Getting started

This guide will be useful for both company owners and project managers. You are responsible for planning and organizing work on projects, leading teams and tracking current progress. You also need to interact with customers and employees to provide them access to the necessary project data. Our software allows you to do all of the above with minimal effort. To manage projects with Riter, you need to be registered with manager rights or be a company owner.

The main owner's responsibility is registration a company in Riter. The rest of owners' capabilities coincide with the manager's role. To get started with Riter as a manager, you need to follow the steps:

Note, that each project can have the only customer and any number of developers. You can add, edit and view all these data on the corresponding pages. General statistics page allows you to track progress on all projects and users. You can navigate through the pages using the main menu items. If you are not sure how some features must work, you can check them on the demo company page.

Switching roles

A project manager in Riter is a developer with additional abilities. To know more about development tools in Riter look through the development guide. You can easily switch between development and management modes. To get to the project management section, click on your nickname in the upper right corner and select an item "Manage company" from the drop-down menu. You can return to the development process by clicking on a particular project name from a drop-down list in the main menu.

Manage company

Customer management

You are able to keep information about all the customers you have worked with in Riter. It may be useful to group projects by customers, track their activity and workload. Click on the 'New customer' in the upper right corner to add a new one. The only information you need to specify is the customer's name. To open a particular customer page click on the required name in the list.

Customers

A customer page

On a customer page you can see a number of hours spent by your development teams on different projects of a certain customer during the previous and the current weeks. Here you can also change the customer's name clicking on the settings icon and specifying a new value. To change a customer of a project go to the project settings and select another one from the list.

Team management

As a manager, you need to organize a team of developers, manage their access to projects, track working process and be aware of each user's contribution. Riter makes it easier to navigate and control all the users data. On the users page you will find a list of all developers with short information about each of them: a full name and a nickname, projects which the user is involved in, a special role if it's assigned to the user. To get on a particular project's or user's page just click on the corresponding name. Icons in the upper right corner of some user's cards tell you about his or her role of a manager or/and an owner. Hover the icon to know its meaning. If a user has no such an icon, this is a usual developer without additional rights.

Users

Adding Riter users

To sign up a new developer in Riter, click on 'New user' and fill in the registration form. You need to specify the user's first and last name, nickname and email. Nickname is a short alias used in the system for convenience. You can find out a developer's full name in any moment by hovering a mouse over his icon or nickname. The email will be used to complete the registration process. To do this, the user should go to the email, click on the received confirmation link and specify the account password on the opened page. All the user's data can be modified later by a manager.

A user page

On a particular user page you can find the profile information (full name, email, etc.) and detailed statistics on worked hours for each project. Here you are also able to revoke the user's access to projects. New users need to be assigned to work on project pages. Also, you can revoke user access to a particular project on its page.

User page

Project management

On the main company management page you will find a list of available projects and short information about them. The submenu allows you to switch between active, disabled (already finished) projects, and project groups. Here you can also find a link to create a new one. You will need to specify its parameters, a customer and developers, give them access to the project before they are able to start work on it.

Project management

New project

Creating a new project, you set the following characteristics:

  • Its name and shortname (for simultaneous working with a group of projects).
  • A customer - the project initiator that can be selected from a list. If you don't have a required customer in the list, you should add a new one before creation of project or leave this field empty.
  • Assign developers from a list to the project.

To edit an existing project or get detailed information about any find it in the list and click on the title to go to the project page.

New project page

New project group

In the submenu on the main page, go to the "Groups" section to create a new group or edit an existing one. There you'll find a list of all available projects and project groups. To create a new one, just choose a new name and specify a set of projects to include. Then everybody who has access to all these projects will be able to work with this group as with a separate project. At the moment, only managers are able to create project groups, so we expect you to create such groups for your team members by request. In future, all developers will be able to do this on their own.

New project group

Project groups may be useful if you have several related projects and need to track all their data simultaneously. At the same time, each of them is an independent application with an own team of developers and you don't want to mix them into one big project. In addition, project groups can be used to combine several projects of a particular user so that he doesn't need to switch between them all the time.

A project page

All project management activities can be performed on this page. Here you will find all information about the chosen project:

  • a project name, a shortname, and a customer;
  • worked hours, activity on the project;
  • tasks statistics grouped by task states;
  • assigned users;
  • project settings.

Click on the settings icon on the right of the project name to modify the project data. You can edit its name, shortname, and select another customer from the list of existing ones. To mark the project as disabled (if it is already completed and accepted by the customer) go to the setting tab below. On this page you will see tabs with information about project story states, users and their statistics. Choose a necessary one to get additional data on them.

Project page

The project "States" tab includes stories statistics grouped by their states: number of stories, general spent (dirty) and estimated (clean) time for each state.

Project users

The "Users" tab contains a list of all users (managers and developers) of your company to assign them to the project or revoke access. Icons of assigned users' are highlighted. Just click an icon to give or revoke access. Hover a user's icon to see his or her full name and nickname.

Project users

Project statistics

Unlike general statistics, this tab shows you report on a particular project. It displays gross worked hours grouped by users, weekdays and weeks. You can filter the data by users and project topics using corresponding filters on the right. Click on some Total column value to get statistics on the particular user grouped by projects and weekdays for the selected week. To get information about some user's activity during a particular weekday, click on the appropriate worked hours value.

Project statistics

Track work progress

General statistics page includes all the company's projects statistics grouped by users, weeks and weekdays. It contains "General" and "Performance" statistic tabs. The first one allows you to find out the amount of time spent by each developer on work for a certain day and the whole week at once. You can exclude particular users and projects from statistics by using the appropriate filters on the right. Note that statistics take into account dirty hours which may differ from clean ones. Click on worked hours in any user Total column to open the general statistics on the special user grouped by projects and weekdays. A choice of a particular day value let you know the detailed statistics on the chosen day for the user. Select option 'Back to statistics' to return to the common table.

General statistics

Move to the "Performance" statistics page to find out productivity of your users. This report shows a ratio of clean hours spent on all tasks of a particular developer to dirty ones. Thus, you will know not only how much your team works, but also how effectively it is, what part of the workday is spent on the project itself, excluding solution of technical issues, discussions, reading documentation, etc.

Performance statistics

Sprints

This page is just informative - you can create, update and archive sprints from the development mode on the project settings page. This means that each user who has access to the project can manage its sprints regardless of his rights.

On this page you can see a list of sprints throughout all projects. Different projects can have the same sprint sections. In the brackets next to a project name you can see a number of tasks in a specific sprint.

Sprints