Guidelines for using Launchpad

From TeamFrednetWiki

Don't use this info; most projects are created/moved to Google code. See: Guidelines_for_tasks#Code_Hosting

2009 10 27

Some groups and subprojects within Team FREDNET use the project hosting service Launchpad for bug tracking, feature tracking, and source code management. Launchpad, which also hosts projects such as Ubuntu, MySQL and Wordpress, is mainly intended for hosting software projects, but we have been allowed by administrators of the service to host other kinds of subprojects, such as hardware and outreach projects.

Contents 1 Users 2 Overview 3 Subprojects 3.1 Creating a new subteam 3.2 Creating a new subproject 4 Blueprints 4.1 Creating blueprints 4.2 Working on blueprints 4.3 Mentoring blueprints 5 Code 5.1 Creating a branch 6 Standards 6.1 Naming items

Users

Instructions for creating a user account have been moved here.

Overview

An overview of the current Team FREDNET Launchpad.net utilization is managed on another page. This page is mainly for how to use or administer the Launchpad.net system.

Subprojects

Creating a new subteam

In Launchpad, we use subteams similarly how to we use groups elsewhere: it is a way of focusing communication and administration of a given activity around a smaller group of people.

1. Go to the team registration page.
2. In the field 'Name', enter a name with a prefix of "team-frednet-", e.g. "team-frednet-rover-control".
3. In the field 'Display Name', enter a suitable title for the team with a suffix of " (Team FREDNET)", e.g. "Rover Control Group (Team FREDNET)".
4. Fill the remaining fields as desired.
5. Click "Create" at the bottom of the page.
6. Go to Team FREDNET's team page.
7. Check the checkbox in front of the name of your new team.
8. Click 'Continue'.

For a complete guide to creating new teams, please see this page.

Creating a new subproject

Before creating a new subproject please check carefully whether the subproject already exists. If you are in doubt you can consult the forum and/or the team-frednet group administrators.

To register a new project, you should first create a new subteam to maintain it, as described above. Once that is done, do the following:

1. Go to the project registration page.
2. In the field 'Name', you should enter a name with a prefix of "frednet-", e.g. "frednet-rover-control".
3. Fill the other fields as desired (leave the 'Part of' field blank).
4. Click the 'Add' button on the bottom of the page.
5. Go to the project page for the new subproject (e.g. http://launchpad.net/frednet-rover-control/).
6. Click the 'Change details' link.
7. Under the 'People' tab, set both fields to the name of the team you created (e.g. "team-frednet-rover-control")
8. Click 'Save changes'.

For a complete guide to creating new projects, please see this page.

Blueprints

A 'blueprint' is a construct in Launchpad that can be used to help track specification and development of a project.

Creating blueprints

Working on blueprints

Mentoring blueprints

Code

Launchpad makes collaboration on software development easy with the Bazaar version control system.

Creating a branch

Something like this ;)

feder@voyager:~/test$ bzr init
feder@voyager:~/test$ bzr add
added test
feder@voyager:~/test$ bzr commit
Committing to: /home/feder/test/
added test
Committed revision 1.                                                          
bzr: ERROR: empty commit message specified
feder@voyager:~/test$ bzr push lp:~anders-feder/+junk/test

https://help.launchpad.net/CreatingAHostedBranch http://doc.bazaar-vcs.org/bzr.dev/en/user-guide/index.html

Standards

Naming items

The following naming scheme should be used for Team FREDNET's items (projects, teams, blueprints etc.) on Launchpad:

• frednet. Reserved for superproject.
• frednet-. Prefix for subprojects.
• team-frednet. The 'superteam' of Team FREDNET of which everyone should be member.
• team-frednet-. Prefix for 'subteams'.
• (Team FREDNET). Suffix for subteam titles.