Ticket #932 (closed defect: fixed)

Opened 19 months ago

Last modified 14 months ago

Unexplained, unlinked references in doc

Reported by: dabrahams Owned by:
Priority: minor Milestone: 0.8.3
Version: 0.8.0 Keywords: docs
Cc:

Description

http://buildbot.net/buildbot/docs/current/Scheduling-Builds.html uses a number of terms that are neither defined by that point in the document nor linked to any kind of explanation.

You could have a “quick” scheduler which used a 30 second timeout, and feeds a single “quick” Builder that uses a VC mode='update' setting.

A separate “full” scheduler would run more comprehensive tests a little while later, to catch more subtle problems. This scheduler would have a longer tree-stable-timer, maybe 30 minutes, and would feed multiple Builders (with a mode= of 'copy', 'clobber', or 'export').

The tree-stable-timer and fileIsImportant decisions are made by the Scheduler.

I think I've guessed what these things are, but it took some mental gymnastics that you could have spared me by introducing the ideas more carefully.

Change History

comment:1 Changed 19 months ago by dustin

  • Keywords docs added
  • Milestone changed from undecided to 0.8.2

Probably the best solution is to rephrase that in general terms, since the buildbot terms are not introduced yet. Do you want to draft up some new language, and I'll commit it?

comment:2 Changed 18 months ago by dustin

  • Milestone changed from 0.8.2 to 0.8.3

comment:3 Changed 14 months ago by Dustin J. Mitchell

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

Better docs in concepts.texinfo

This smooths out the introduction of some concepts in the "Scheduling Builds" section. Fixes #932

Changeset: 49402abde40b4ddbe4800458c256210c159ffec2

Note: See TracTickets for help on using tickets.