Launchpad user documentation¶
Launchpad is designed for effective open-source collaboration. It provides the tools you need to build open-source projects and share them with the world.
Launchpad gives you access to everything necessary to build and publish software including code hosting, issue tracking, and request tracking for bugs. Features unique to this platform include build capacities for different languages, and package formats for different architectures such as AMD64, AMD64v3, ARM, and RISC-V.
Launchpad also offers tracking capabilities across issue trackers to seamlessly communicate with upstream projects.
In this documentation¶
Get to know Launchpad¶
New to Launchpad? Start here for an overview of the platform and its key features, and a tour of a standard Launchpad page.
Overview: Get started with Launchpad • What is Launchpad • Page tour •
Feature highlights: Personal Package Archives • Answer tracker • The bug tracker • Bug watches • Bug branch linking
Accounts and access¶
Set up and secure your Launchpad identity by creating an account and adding SSH and OpenPGP keys. Signing in to other sites, understand how your contributions are tracked and how to manage mail from Launchpad.
Manage your account: Create and personalize your account • Manage your account • Merge two or more accounts • Close your account
Keys and sign-in: Import your SSH key • Import an OpenPGP key •
Understand your account: What can you do with a Launchpad account? • Account karma • Rationale headers in email
Reference: Troubleshooting your account • Email address already in use • SSH fingerprints • User preferences
Projects and code hosting¶
Host your project’s Git repositories, review and merge changes, and understand how code hosting, imports, and continuous integration fit together.
Projects basics: Register your project • Transfer project ownership • Close a project
Code hosting: Host your project’s code • Work with Git repositories • Create and maintain a personal branch • Create and manage a merge proposal • Code imports • Branch privacy
Manage software projects: Project registration options • Project groups • Planning and recording releases • Making project files available for download • Publishing project announcements • Link code changes to bugs • Continuous integration
Reference: Proprietary hosting options • Roles in code reviews • Comment syntax • Project licenses • General privacy, confidentiality, and disclosure
Build and publish software packages¶
Build and distribute software packages from your source code without managing build infrastructure or hosting your archives, including Debian packages in PPAs, as well as snaps, rocks, charms, and OCI images.
Personal package archives basics: Install software from PPAs • Install software from private PPAs • Install software from a PPA snapshot • Create a PPA • Upload a package to a PPA
Manage PPAs: Copy packages • Delete packages • Create a source package recipe • Understand source package recipes • Troubleshoot package upload errors
Build craft artifacts: Build snaps • Build rocks • Build charms • Build OCI images
Reference: Personal Package Archive • Building a source package • Build scores • Builder specs • Daily build naming conventions • Source builds knowledge base • Live filesystems
Bug tracking¶
File, subscribe to, and manage bugs across your projects. Link them to code changes, and integrate reports from external trackers such as Bugzilla, Trac, GitLab, and Mantis.
File and manage bugs: File a bug • Display bug reporting guidelines • Link a bug to a branch • Subscribe and unsubscribe to bugs • Turning a bug into a question • Import your project’s bug history • Multi-project bugs
Email interface and external trackers: Use the Launchpad email interface • Manage bugs through email • Use the Bugzilla plugin • Use the Trac plugin • Use the Malone XMLRPC interface • Track bugs with Mantis • Bug tracker plugin API
Reference: Bug statuses • Bug attachments • Bug expiry • Bug heat • Bug subscription • External bug statuses • External bug tracker interoperability • Email interface commands • The Malone XMLRPC interface • Bug supervisor role
Teams and community¶
Group contributors into teams, coordinate around projects, and take part in the community through Launchpad Answers.
Teams: Creating and running teams • Team management • Indirect team members • Team repositories
Launchpad Answers and support: Launchpad Answer Tracker • Asking for help • Question lifecycle • Help the community • Support in your native language
Collaboration: Contacting others and managing your contact information
Reference: Badges • Project announcements • Getting support (best practices)
Translations¶
Coordinate localization of your software with Launchpad’s Translations feature, from preparing your project to importing, exporting, and sharing translations.
Translate your project: Translating with Launchpad • Using Rosetta • Translation prerequisites • Software translation fundamentals • Managing, tracking, and contributing translations • Translation groups • Preparing to translate
Project translation tasks: Import project translations • Import translation templates • Export translations • Exporting partial PO files
Reference: Translation guidelines • Language-specific guides • Permissions policies • Import policy • Launchpad translators group • Licensing • Plural forms • Translation best practices • Reusing translations best practices • PO templates • Translation sharing and suggestions
API and automation¶
Script Launchpad operations through its REST-style API and the launchpadlib
Python client, and automate external integrations with webhooks.
Tutorial: Get started with launchpadlib
Use the API: Launchpad web services API • Sign web requests • Using launchpadlib • The Python API • Authenticate with a text browser • Integrate a website • View supported fields and methods
Understand the API: The launchpadlib API • Integrate third-party applications • Launchpad web service
Reference: API compatibility • Applications using the API • Webhooks
How this documentation is organized¶
This documentation uses the Diátaxis documentation structure.
Tutorial: tutorials to help you interact with Launchpad.
How-to: step-by-step instructions for key operations and common tasks.
Reference: specifications, APIs, architecture.
Explanation: discussion and clarification of user topics.
Project and community¶
Launchpad is a member of the Ubuntu family. It’s an open source project that warmly welcomes community contributions, suggestions, fixes and constructive feedback.