Default the configuration page for self-hosted runners to Linux

[jenschelkopf]

Default the configuration page for self-hosted runners to Linux

[zeke]

What determines the order of the tabs?

Here's the HTML for the tabs: https://github.com/github/docs/blob/5395b9371056e7c8eb9b649e5c1de4de80613155/includes/article.html#L31:L40

Here's the JavaScript file that dynamically updates the tabs and the displayed content on page load: https://github.com/github/docs/blob/main/javascripts/display-platform-specific-content.js

Here's the file where tests should be added for any changes to the existing platform-switching behavior: https://github.com/github/docs/blob/main/tests/browser/browser.js (Note that the platform-switching feature was added before we added this Puppeteer headless browser testing capability, so there are no existing browser tests for the current platform-switching functionality)

I hope that helps, @Simran-B!

[Simran-B]

Thanks @zeke for all the information! I created a PR: #1917

Currently, the default tab is Mac.

This isn't the case (anymore?), the default tab is based on the user's operating system, which falls back to Mac if it's none of the supported platforms.

[Simran-B]

Yup, see the documentation about the defaultPlatform frontmatter here: https://github.com/github/docs/blob/main/content/README.md#defaultplatform

[megbird]

@jenschelkopf, while I don't disagree, I don't think there is any way to set a default tab. @github/content-platform-engineering, I've looked in our internal docs but didn't see much information on the context switcher--can y'all confirm that there is technically no way to do this?

If not, we could change the order of the tabs to where linux is first, if no one minds the switcher OS order won't be consistent in our docs. Adding this to our bug fix board 😄

[zeke]

This seems like reasonable request to me. We could consider introduce a new frontmatter value like defaultPlatform or similar, which would allow content authors to specify this on any articles that need it.

[timeyoutakeit]

I believe this is an engineering issue rather than content (fwiw, it looks like Linux does appear first in the content)

[zeke]

this is an engineering issue

agreed 👍🏼

[Simran-B]

it looks like Linux does appear first in the content

What determines the order of the tabs? If it's not the content, and if it's also not sorted alphabetically (it's Mac, Windows, Linux in above screenshot), then how does the current tab order come about?

[github-actions]

This issue is stale because it has been open 60 days with no activity.

[jenschelkopf]

IMO, the tab should not default to the user's OS. The user's OS is not related to the user's runner type. Linux is by far the most common runner type, so we should default to Linux always.

[Simran-B]

I agree that it does not make sense for runners, but what about pages like this one?
https://docs.github.com/en/free-pro-team@latest/desktop/installing-and-configuring-github-desktop/getting-started-with-github-desktop

For the actions docs, Linux can be set as defaultPlatform with my PR on a per page basis.

[github-actions]

This issue is stale because it has been open 60 days with no activity.

[janiceilene]

It looks like the work for this one was completed in #1917, so I'm going to close this out!