Update some comments

dot/sync/chain_sync.go

@@ -61,7 +61,7 @@ type peerState struct {
 // workHandler should be implemented by `bootstrapSync` and `tipSync`
 type workHandler interface {
 	// handleNewPeerState returns a new worker based on a peerState.
-	// It returns the error errNoWorker in which case we do nothing.
+	// The worker may be nil in which case we do nothing.
 	handleNewPeerState(*peerState) (*worker, error)
 
 	// handleWorkerResult handles the result of a worker, which may be

lib/babe/crypto.go

@@ -28,8 +28,8 @@ func makeTranscript(randomness Randomness, slot, epoch uint64) *merlin.Transcrip
 }
 
 // claimPrimarySlot checks if a slot can be claimed.
-// If it cannot be claimed the wrapped error errPrimarySlotThreshold
-// is returned.
+// If it cannot be claimed, the wrapped error
+// errOverPrimarySlotThreshold is returned.
 // https://github.com/paritytech/substrate/blob/master/client/consensus/babe/src/authorship.rs#L239
 func claimPrimarySlot(randomness Randomness,
 	slot, epoch uint64,

lib/babe/epoch.go

@@ -170,7 +170,8 @@ func (b *Service) incrementEpoch() (uint64, error) {
 // runLottery runs the lottery for a specific slot number.
 // It returns an encoded VrfOutputAndProof if the validator is authorised
 // to produce a block for that slot.
-// It returns the wrapped error errPrimarySlotThreshold if it is not authorised.
+// It returns the wrapped error errOverPrimarySlotThreshold
+// if it is not authorised.
 // output = return[0:32]; proof = return[32:96]
 func (b *Service) runLottery(slot, epoch uint64) (*VrfOutputAndProof, error) {
 	return claimPrimarySlot(