add some comments

Signed-off-by: Andrew Thornton <[email protected]>

Author: zeripath

options/locale/locale_en-US.ini

@@ -2960,28 +2960,36 @@ monitor.process.cancel_notices =  Cancel: <strong>%s</strong>?
 monitor.process.children = Children
 
 monitor.pprof = PProf Profiles
+monitor.pprof.description = PProf profiles provide runtime profiling data.
+monitor.pprof.description_2 = Text formats can be read directly but most data is in the format expected by the golang pprof visualization tool
+
 monitor.pprof.download = Download
 monitor.pprof.duration = Duration
 monitor.pprof.duration_placeholder = e.g. 30s
 monitor.pprof.duration_invalid = Invalid duration - duration must be a golang duration string
 
 monitor.pprof.cpuprofile = CPU Profile
+monitor.pprof.cpuprofile.description = CPU profile determines where Gitea spends its time while actively consuming CPU cycles
 
 monitor.pprof.fgprof = Full Go Profile
+monitor.pprof.fgprof.description = Full Go profile provides wall clock profiling combining the CPU Profile with IO time
 monitor.pprof.fgprof.format = Format
 
 monitor.pprof.named_profiles = Named Profiles
+monitor.pprof.named_profiles.description = Go provides a number of named profiles for other profiling
 monitor.pprof.named_profiles.name = Name
 monitor.pprof.named_profiles.debug = Format
 monitor.pprof.named_profiles.format_pprof = pprof
 monitor.pprof.named_profiles.format_text = text
 monitor.pprof.named_profiles.format_goroutine = custom/goroutine
 
+monitor.pprof.stacktrace.description = Stacktraces provides stacktraces for all current goroutines mapped with Gitea's internal processes
 monitor.pprof.stacktrace.flat = Do not nest processes under their parents
 monitor.pprof.stacktrace.no-system = Do not include go-routines associated with system processes
 monitor.pprof.stacktrace.format = Format
 
 monitor.pprof.trace = Trace
+monitor.pprof.trace.description = Trace provides tracing that can be used by the go tracing tool
 
 monitor.queues = Queues
 monitor.queue = Queue: %s

templates/admin/pprof.tmpl

@@ -2,9 +2,12 @@
 	{{.locale.Tr "admin.monitor.pprof"}}
 </h4>
 <div class="ui attached segment">
+	<p>{{.locale.Tr  "admin.monitor.pprof.description"}}</p>
+	<p>{{.locale.Tr  "admin.monitor.pprof.description_2"}}</p>
 	<h4>{{.locale.Tr "admin.monitor.pprof.cpuprofile"}}</h4>
 	<form action="{{AppSubUrl}}/admin/monitor/cpu-profile">
 		<div class="ui form">
+			<div class="help">{{.locale.Tr "admin.monitor.pprof.cpuprofile.description"}}</div>
 			<div class="field">
 				<label for="pprof-cpuprofile-duration">{{.locale.Tr "admin.monitor.pprof.duration"}}</label>
 				<input id="pprof-cpuprofile-duration" type="text" name="duration" placeholder="{{.locale.Tr "admin.monitor.pprof.duration_placeholder"}}">
@@ -15,6 +18,7 @@
 	<h4>{{.locale.Tr "admin.monitor.pprof.fgprof"}}</h4>
 	<form action="{{AppSubUrl}}/admin/monitor/fgprof">
 		<div class="ui form">
+			<div class="help">{{.locale.Tr "admin.monitor.pprof.fgprof.description"}}</div>
 			<div class="field">
 				<label for="pprof-fgprof-duration">{{.locale.Tr "admin.monitor.pprof.duration"}}</label>
 				<input id="pprof-fgprof-duration" type="text" name="duration" placeholder="{{.locale.Tr "admin.monitor.pprof.duration_placeholder"}}">
@@ -32,6 +36,7 @@
 	<h4>{{.locale.Tr "admin.monitor.stacktrace"}}</h4>
 	<form action="{{AppSubUrl}}/admin/monitor/stacktrace-profile">
 		<div class="ui form">
+			<div class="help">{{.locale.Tr "admin.monitor.pprof.stacktrace.description"}}</div>
 			<div class="inline field">
 				<div class="ui checkbox">
 					<input id="pprof-stacktrace-flat" type="checkbox" tabindex="0" class="hidden" name="flat">
@@ -54,19 +59,10 @@
 			<input class="ui button basic" type="submit" value="{{.locale.Tr "admin.monitor.pprof.download"}}">
 		</div>
 	</form>
-	<h4>{{.locale.Tr "admin.monitor.pprof.trace"}}</h4>
-	<form action="{{AppSubUrl}}/admin/monitor/trace">
-		<div class="ui form">
-			<div class="field">
-				<label for="pprof-trace-duration">{{.locale.Tr "admin.monitor.pprof.duration"}}</label>
-				<input id="pprof-trace-duration" type="text" name="duration" placeholder="{{.locale.Tr "admin.monitor.pprof.duration_placeholder"}}">
-			</div>
-			<input class="ui button basic" type="submit" value="{{.locale.Tr "admin.monitor.pprof.download"}}">
-		</div>
-	</form>
 	<h4>{{.locale.Tr "admin.monitor.pprof.named_profiles"}}</h4>
 	<form action="{{AppSubUrl}}/admin/monitor/profile">
 		<div class="ui form">
+			<div class="help">{{.locale.Tr "admin.monitor.pprof.named_profiles.description"}}</div>
 			<div class="field">
 				<label for="pprof-named_profiles-name">{{.locale.Tr "admin.monitor.pprof.named_profiles.name"}}</label>
 				<select class="ui search dropdown" id="pprof-named_profiles-name" name="name">
@@ -86,4 +82,15 @@
 			<input class="ui button basic" type="submit" value="{{$.locale.Tr "admin.monitor.pprof.download"}}">
 		</div>
 	</form>
+	<h4>{{.locale.Tr "admin.monitor.pprof.trace"}}</h4>
+	<form action="{{AppSubUrl}}/admin/monitor/trace">
+		<div class="help">{{.locale.Tr "admin.monitor.pprof.trace.description"}}</div>
+		<div class="ui form">
+			<div class="field">
+				<label for="pprof-trace-duration">{{.locale.Tr "admin.monitor.pprof.duration"}}</label>
+				<input id="pprof-trace-duration" type="text" name="duration" placeholder="{{.locale.Tr "admin.monitor.pprof.duration_placeholder"}}">
+			</div>
+			<input class="ui button basic" type="submit" value="{{.locale.Tr "admin.monitor.pprof.download"}}">
+		</div>
+	</form>
 </div>