diff --git a/app/api/controller/reposettings/general.go b/app/api/controller/reposettings/general.go
index f2c51bc3b..e871fc644 100644
--- a/app/api/controller/reposettings/general.go
+++ b/app/api/controller/reposettings/general.go
@@ -22,7 +22,7 @@ import (
 
 // GeneralSettings represent the general repository settings as exposed externally.
 type GeneralSettings struct {
-	FileSizeLimit *int64 `json:"file_size_limit" yaml:"file_size_limit"`
+	FileSizeLimit *int64 `json:"file_size_limit" yaml:"file_size_limit" description:"file size limit in bytes"`
 	GitLFSEnabled *bool  `json:"git_lfs_enabled" yaml:"git_lfs_enabled"`
 }
 
diff --git a/types/repo.go b/types/repo.go
index 886aa3243..85a65c775 100644
--- a/types/repo.go
+++ b/types/repo.go
@@ -48,7 +48,7 @@ type Repository struct {
 	LastGITPush int64  `json:"last_git_push" yaml:"last_git_push"`
 
 	// Size of the repository in KiB.
-	Size int64 `json:"size" yaml:"size"`
+	Size int64 `json:"size" yaml:"size" description:"size of the repository in KiB"`
 	// SizeUpdated is the time when the Size was last updated.
 	SizeUpdated int64 `json:"size_updated" yaml:"size_updated"`