diff --git a/links/link.go b/links/link.go
index 53ac0d1c9..a93bb2359 100644
--- a/links/link.go
+++ b/links/link.go
@@ -74,7 +74,8 @@ var _ yaml.Unmarshaler = (*LinkDefinition)(nil)
 // UnmarshalYAML deserializes links passed via topology file into LinkDefinition struct.
 // It supports both the brief and specific link type notations.
 func (ld *LinkDefinition) UnmarshalYAML(unmarshal func(interface{}) error) error {
-	// avoid recursion used only need to unmarshal the type field.
+	// struct to avoid recursion when unmarshalling
+	// used only to unmarshal the type field.
 	var a struct {
 		Type string `yaml:"type"`
 	}
diff --git a/links/link_veth.go b/links/link_veth.go
index f83eb4485..6ba217740 100644
--- a/links/link_veth.go
+++ b/links/link_veth.go
@@ -17,7 +17,7 @@ type LinkVEthRaw struct {
 	Endpoints        []*EndpointRaw `yaml:"endpoints"`
 }
 
-// ToLinkBriefRaw converts the raw link into a LinkConfig.
+// ToLinkBriefRaw converts the raw link into a LinkBriefRaw.
 func (r *LinkVEthRaw) ToLinkBriefRaw() *LinkBriefRaw {
 	lc := &LinkBriefRaw{
 		Endpoints:        []string{},