Make all instances of doc links in logs clickable #2355
Conversation
angelapwen
force-pushed
the
angelapwen/make-log-links-clickable
branch
from
2e6d089
to
90ece33
Compare
src/codeql.test.ts
Outdated
| @@ -912,8 +912,8 @@ test("runTool summarizes autobuilder errors", async (t) => { | |||
| instanceOf: CommandInvocationError, | |||
| message: | |||
| "We were unable to automatically build your code. Please provide manual build steps. " + | |||
| "For more information, see " + | |||
| "https://docs.github.com/en/code-security/code-scanning/troubleshooting-code-scanning/automatic-build-failed. " + | |||
| "See https://docs.github.com/en/code-security/code-scanning/troubleshooting-code-scanning/automatic-build-failed " + | |||
There was a problem hiding this comment.
I'm wondering whether it makes sense to export these into their own variables, and even better perhaps in their own file, something like src/docs-urls.ts or something similar.
Doing so would have the benefit of them being more centrally organised, so we can do a one-step global replace if anything changes by just changing the value of the constant to the new URL, and have the documentation strings be automatically updated everywhere.
There was a problem hiding this comment.
I did this in an enum, similar to the way we have EnvVar for shared environment variables 😄 it was a really good idea — from there I found other instances where we had docs links that ended with periods!
src/autobuild.ts
Outdated
| : "" | ||
| }`, | ||
| ); | ||
| core.exportVariable(envVar, "false"); | ||
| } else { | ||
| logger.info( | ||
| `Enabling ${featureName}. This can be disabled by setting the ${envVar} environment variable to 'false' (see ${envDoc}).`, | ||
| `Enabling ${featureName}. This can be disabled by setting the ${envVar} environment variable to 'false' (see ${envDoc} for more information).`, |
There was a problem hiding this comment.
In some of these strings we have the URL reference inside of a parenthesis, whereas in others we end the sentence with a period and start a new one.
I'm curious if there are any benefits to being more consistent on that front.
There was a problem hiding this comment.
I definitely don't see any downsides to standardizing our docs links — I removed all the parenthetical URL references!
angelapwen
dismissed stale reviews from henrymercer and NlightNFotis
via
10d5681
angelapwen
force-pushed
the
angelapwen/make-log-links-clickable
branch
from
90ece33
to
10d5681
Compare
Always say "see $URL for more information" without parentheses.
angelapwen
force-pushed
the
angelapwen/make-log-links-clickable
branch
from
10d5681
to
edfef27
Compare
Thanks!! I've waited too long to get back to this PR 😆 so I won't write the CodeQL query this time. I think the new |
angelapwen
force-pushed
the
angelapwen/make-log-links-clickable
branch
from
33902d8
to
892ff9e
Compare
Fixes #2354.
This PR updates all log messages with links to GitHub docs so that they are not succeeded by punctuation marks, in order to make sure the links are clickable from our logs.
Merge / deployment checklist