Opened 7 years ago

Closed 7 years ago

#2488 closed defect (fixed)

The tutorial and the manual seems to recommend different ways of installing

Reported by: Sleft Owned by:
Priority: minor Milestone: undecided
Version: 0.8.7p1 Keywords: docs
Cc:

Description

The tutorial says

(The preferred method would be to install buildbot from packages of your distribution.)

The manual does not say anything about preferred method but it says

The easiest way to install Buildbot is using 'pip'.

which seems to imply that using 'pip' is the preferred way. So which way is it? Should the documents be changed so that they do not seem contradictory?

Change History (3)

comment:1 Changed 7 years ago by dustin

The tutorial is trying to find the simplest way, and generally 'apt-get install' or 'port install' or the like is the easiest way.

The manual, on the other hand, is looking for the most general way, and that's pip -- it allows you to upgrade or downgrade (or stay put) easily, without waiting for downstream packages. The manual should probably *also* mention using packages, but include a warning about version lag and possible difficulty upgrading.

Do you want to make a patch for that?

comment:2 Changed 7 years ago by Sleft

As I sent patches via github before I guess that is the correct way to proceed here too, right?

I have added patches for this

to a pending pull request of mine.

comment:3 Changed 7 years ago by dustin

  • Resolution set to fixed
  • Status changed from new to closed

Thanks - merging it now

Note: See TracTickets for help on using tickets.