Code optimized (#523)

* optimized markdown generator

* optimized markdown generator

* optimized markdown generator

* add more comment

* add comment

* add comment

* add comments for rpc tool

* add comments for model tool

* add comments for model tool

* add comments for model tool

* add comments for config tool

* add comments for config tool

* add comments

* add comments

* add comments

* add comments

* add comment

* remove rpc main head info

* add comment

* optimized

Co-authored-by: anqiansong <anqiansong@xiaoheiban.cn>

tools/goctl/rpc/generator/mkdir.go

@@ -23,6 +23,7 @@ const (
 )
 
 type (
+	// DirContext defines a rpc service directories context
 	DirContext interface {
 		GetCall() Dir
 		GetEtc() Dir
@@ -36,11 +37,13 @@ type (
 		GetServiceName() stringx.String
 	}
 
+	// Dir defines a directory
 	Dir struct {
 		Base     string
 		Filename string
 		Package  string
 	}
+
 	defaultDirContext struct {
 		inner       map[string]Dir
 		serviceName stringx.String
@@ -159,6 +162,7 @@ func (d *defaultDirContext) GetServiceName() stringx.String {
 	return d.serviceName
 }
 
+// Valid returns true if the directory is valid
 func (d *Dir) Valid() bool {
 	return len(d.Filename) > 0 && len(d.Package) > 0
 }