diff --git a/docs/src/diagnostics/make_diagnostic_table.jl b/docs/src/diagnostics/make_diagnostic_table.jl
index e7b7cedab6..2fd993fd8f 100644
--- a/docs/src/diagnostics/make_diagnostic_table.jl
+++ b/docs/src/diagnostics/make_diagnostic_table.jl
@@ -16,7 +16,8 @@ for d in values(CL.Diagnostics.ALL_DIAGNOSTICS)
     push!(comments, d.comments)
     push!(standard_names, d.standard_name)
 end
-data = hcat(short_names, long_names, units, comments, standard_names)
+i = sortperm(short_names) # indices of short_names sorted alphabetically
+data = hcat(short_names[i], long_names[i], units[i], comments[i], standard_names[i])
 pretty_table(
     data;
     autowrap = true,