Merge pull request #115383 from my-git9/imporve/note

Cleanup: improve some note for code

staging/src/k8s.io/apimachinery/pkg/util/duration/duration.go

@@ -21,7 +21,7 @@ import (
 	"time"
 )
 
-// ShortHumanDuration returns a succint representation of the provided duration
+// ShortHumanDuration returns a succinct representation of the provided duration
 // with limited precision for consumption by humans.
 func ShortHumanDuration(d time.Duration) string {
 	// Allow deviation no more than 2 seconds(excluded) to tolerate machine time
@@ -42,7 +42,7 @@ func ShortHumanDuration(d time.Duration) string {
 	return fmt.Sprintf("%dy", int(d.Hours()/24/365))
 }
 
-// HumanDuration returns a succint representation of the provided duration
+// HumanDuration returns a succinct representation of the provided duration
 // with limited precision for consumption by humans. It provides ~2-3 significant
 // figures of duration.
 func HumanDuration(d time.Duration) string {

staging/src/k8s.io/apimachinery/pkg/util/errors/errors.go

@@ -214,7 +214,7 @@ func CreateAggregateFromMessageCountMap(m MessageCountMap) Aggregate {
 	return NewAggregate(result)
 }
 
-// Reduce will return err or, if err is an Aggregate and only has one item,
+// Reduce will return err or nil, if err is an Aggregate and only has one item,
 // the first item in the aggregate.
 func Reduce(err error) error {
 	if agg, ok := err.(Aggregate); ok && err != nil {

staging/src/k8s.io/apimachinery/pkg/util/framer/framer.go

@@ -32,7 +32,7 @@ func NewLengthDelimitedFrameWriter(w io.Writer) io.Writer {
 	return &lengthDelimitedFrameWriter{w: w}
 }
 
-// Write writes a single frame to the nested writer, prepending it with the length in
+// Write writes a single frame to the nested writer, prepending it with the length
 // in bytes of data (as a 4 byte, bigendian uint32).
 func (w *lengthDelimitedFrameWriter) Write(data []byte) (int, error) {
 	binary.BigEndian.PutUint32(w.h[:], uint32(len(data)))