From 1f1e1eebc965fbafb41772b5c6373d99ad7e4b36 Mon Sep 17 00:00:00 2001
From: greg linton <greg@influxdata.com>
Date: Thu, 23 Jan 2020 10:40:35 -0700
Subject: [PATCH] chore: add comments to exported bits

---
 snowflake/gen.go | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/snowflake/gen.go b/snowflake/gen.go
index 46dfed7a1..945e0c5fa 100644
--- a/snowflake/gen.go
+++ b/snowflake/gen.go
@@ -25,11 +25,13 @@ const (
 	timeMask     = ^(-1 << timeBits)
 )
 
+// Generator defines a snowflake generator structure.
 type Generator struct {
 	state   uint64
 	machine uint64
 }
 
+// New creates a new generator.
 func New(machineID int) *Generator {
 	if machineID < 0 || machineID > serverMax {
 		panic(fmt.Errorf("invalid machine id; must be 0 ≤ id < %d", serverMax))
@@ -40,10 +42,12 @@ func New(machineID int) *Generator {
 	}
 }
 
+// MachineID returns the machine's ID.
 func (g *Generator) MachineID() int {
 	return int(g.machine >> serverShift)
 }
 
+// Next generates and returns a universally unique uint64.
 func (g *Generator) Next() uint64 {
 	var state uint64
 
@@ -95,12 +99,14 @@ func (g *Generator) Next() uint64 {
 	return state | g.machine
 }
 
+// NextString generates and returns a universally unique uint64 as a string.
 func (g *Generator) NextString() string {
 	var s [11]byte
 	encode(&s, g.Next())
 	return string(s[:])
 }
 
+// AppendNext appends the byte slice of a unique uint64 to s.
 func (g *Generator) AppendNext(s *[11]byte) {
 	encode(s, g.Next())
 }