641fedbb2b65a9b9fe8ae820b80bf844b41f773b
gperez2
  Wed Apr 23 13:38:29 2025 -0700
Adding more information and a link for hubCheckâ€'s missing description page for track warning, refs #32998

diff --git src/hg/utils/hubCheck/hubCheck.c src/hg/utils/hubCheck/hubCheck.c
index a173bb0c140..81ba76ed011 100644
--- src/hg/utils/hubCheck/hubCheck.c
+++ src/hg/utils/hubCheck/hubCheck.c
@@ -905,31 +905,33 @@
     // check that type line is syntactically correct regardless of
     // if we actually want to check the data file itself
     boolean foundTypeError = checkTypeLine(genome, tdb, errors, options);
 
     // No point in checking the data file if the type setting is incorrect,
     // since hubCheckBigDataUrl will error out early with a less clear message
     // if the type line is messed up. This has the added benefit of providing
     // consistent messaging on command line interface vs web interface
     if (!foundTypeError && options->checkFiles)
         hubCheckBigDataUrl(hub, genome, tdb);
 
     if (!sameString(tdb->track, "cytoBandIdeo"))
         {
         trackHubAddDescription(genome->trackDbFile, tdb);
         if (!tdb->html)
-            warn("warning: missing description page for track: '%s'", tdb->track);
+            warn("warning: missing description page for track. Add 'html %s.html' line to the '%s' track stanza. "
+                 "To learn more about adding description pages, see our documentation: http://genome.ucsc.edu/goldenPath/help/trackDb/trackDbHub.html",
+                 tdb->track, tdb->track);
         }
 
     if (!trackIsContainer && sameString(trackDbRequiredSetting(tdb, "type"), "bigWig"))
         {
         char *autoScaleSetting = trackDbLocalSetting(tdb, "autoScale");
         if (autoScaleSetting && !sameString(autoScaleSetting, "off") && !sameString(autoScaleSetting, "on"))
             {
             errAbort("track \"%s\" has value \"%s\" for autoScale setting, "
                     "valid autoScale values for individual bigWig tracks are \"off\" or \"on\" only. "
                     "If \"%s\" is part of a bigWig composite track and you want to use the "
                     "\"%s\" setting, only declare \"autoScale group\" in the parent stanza",
                     trackHubSkipHubName(tdb->track), autoScaleSetting, trackHubSkipHubName(tdb->track), 
                     autoScaleSetting);
             }
         }