Bazaar in five minutes tutorial has errors

Bug #813577 reported by Jean-Francois Caron
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
Bazaar
Confirmed
High
Unassigned
Breezy
Triaged
Medium
Unassigned

Bug Description

I learned about bazaar and launchpad from: http://doc.bazaar.canonical.com/latest/en/mini-tutorial/
however this tutorial has a few errors, namely:
"After creating the repository, change to that directory, and create the project’s main trunk branch." followed by a list of commands isn't quite clear about what those commands are. Is there a separate "create the repository" step that needs to be done before those four commands are issued? It should say instead "The following commands will create the repository, change to the directory where the repository will live, and then create the main trunk branch" or something like that.

Second, in the section about publishing your project on launchpad, the instructions completely neglect the necessary step of telling bzr your launchpad ID name: bzr launchpad-id <yourname>. It was really easy to find the correct command, but for a complete newbie, errors in the basic guide are a good reason to stop reading.

Tags: doc
Revision history for this message
Martin Pool (mbp) wrote : Re: [Bug 813577] [NEW] Bazaar in five minutes tutorial has errors

affects bzr
On Jul 21, 2011 1:25 AM, "Jean-Francois Caron" <email address hidden> wrote:
> Public bug reported:
>
> I learned about bazaar and launchpad from:
http://doc.bazaar.canonical.com/latest/en/mini-tutorial/
> however this tutorial has a few errors, namely:
> "After creating the repository, change to that directory, and create the
project’s main trunk branch." followed by a list of commands isn't quite
clear about what those commands are. Is there a separate "create the
repository" step that needs to be done before those four commands are
issued? It should say instead "The following commands will create the
repository, change to the directory where the repository will live, and then
create the main trunk branch" or something like that.
>
> Second, in the section about publishing your project on launchpad, the
> instructions completely neglect the necessary step of telling bzr your
> launchpad ID name: bzr launchpad-id <yourname>. It was really easy to
> find the correct command, but for a complete newbie, errors in the basic
> guide are a good reason to stop reading.
>
> ** Affects: bzr-alldocs
> Importance: Undecided
> Status: New
>
>
> ** Tags: documentation
>
> --
> You received this bug notification because you are a member of Bazaar
> Developers, which is the registrant for Bazaar All Docs Website.
> https://bugs.launchpad.net/bugs/813577
>
> Title:
> Bazaar in five minutes tutorial has errors
>
> To manage notifications about this bug go to:
> https://bugs.launchpad.net/bzr-alldocs/+bug/813577/+subscriptions

Martin Pool (mbp)
affects: bzr-alldocs → bzr
Changed in bzr:
importance: Undecided → High
status: New → Confirmed
Jelmer Vernooij (jelmer)
tags: added: check-for-breezy
Jelmer Vernooij (jelmer)
tags: added: doc
removed: check-for-breezy documentation
Changed in brz:
status: New → Triaged
importance: Undecided → Medium
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.