Add comments on exposed vars and functions

pkg/service/v0/service.go

@@ -32,6 +32,7 @@ func NewService(cfg *config.Config, logger log.Logger) Service {
 	return service
 }
 
+// RegisterDefaultRoles composes default roles and saves them. Skipped if the roles already exist.
 func (g Service) RegisterDefaultRoles() {
 	// FIXME: we're writing default roles per service start (i.e. twice at the moment, for http and grpc server). has to happen only once.
 	for _, role := range generateBundlesDefaultRoles() {

pkg/util/resource_helper.go

@@ -3,6 +3,7 @@ package util
 import "github.com/owncloud/ocis-settings/pkg/proto/v0"
 
 const (
+	// ResourceIDAll declares on a resource that it matches any id
 	ResourceIDAll = "all"
 )