Address comments

Signed-off-by: JeffMboya <jangina.mboya@gmail.com>

Author: JeffMboya

domains/service.go

@@ -63,6 +63,7 @@ func (svc service) CreateDomain(ctx context.Context, session authn.Session, d Do
 
 	d.CreatedAt = time.Now().UTC()
 
+	// Domain is created in repo first, because Roles table have foreign key relation with Domain ID
 	dom, err := svc.repo.SaveDomain(ctx, d)
 	if err != nil {
 		return Domain{}, []roles.RoleProvision{}, errors.Wrap(svcerr.ErrCreateEntity, err)
@@ -156,6 +157,7 @@ func (svc service) DisableDomain(ctx context.Context, session authn.Session, id
 	return dom, nil
 }
 
+// Only SuperAdmin can freeze the domain.
 func (svc service) FreezeDomain(ctx context.Context, session authn.Session, id string) (Domain, error) {
 	status := FreezeStatus
 	updatedAt := time.Now().UTC()
@@ -339,6 +341,7 @@ func (svc *service) DeleteInvitation(ctx context.Context, session authn.Session,
 	return nil
 }
 
+// Add addition removal of user from invitations.
 func (svc *service) RemoveEntityMembers(ctx context.Context, session authn.Session, entityID string, members []string) error {
 	for _, member := range members {
 		if err := svc.repo.DeleteInvitation(ctx, member, entityID); err != nil && err != repoerr.ErrNotFound {