Skip to content

Create initial-setup-pop.md #1298

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 1 commit into from
Closed

Conversation

Socialhappiness
Copy link
Contributor

Modifying the install pop article to be more focused on the initial setup, removing content that may confuse people who didn't download and install the iso themselves. Preparing support page for upcoming review on mainstream media targeting windows 10 users switching to Linux.

Modifying the install pop article to be more focused on the initial setup, removing content that may confuse people who didn't download and install the iso themselves. Preparing support page for upcoming review on mainstream media targeting windows 10 users switching to Linux.
@thomas-zimmerman thomas-zimmerman self-requested a review July 18, 2025 18:00
Copy link
Contributor

@thomas-zimmerman thomas-zimmerman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm seeing all of the content and images that I would expect to see on the article when doing the live preview.

@leviport
Copy link
Member

This is the same info from https://support.system76.com/articles/install-pop/#installing-pop_os

What is the purpose of duplicating it into a new hidden article?

@leviport
Copy link
Member

If the intention is to show gnome-initial-setup, then this content isn't what you want. This is an installer walkthrough. Initial setup doesn't appear until after rebooting, which this content does not cover.

@Socialhappiness
Copy link
Contributor Author

The idea is to present the content to a new user who is powering on Pop for the first time (but that didn't install it and doesn't plan to distrohop). A user that uses a web browser and word processor and just wants to know what to expect.
What if we change it to Installer walk-thru as the title? Or something along those lines? Powering on Pop!_OS for the first time?
And Add the initial setup to this same one?
I had it hidden because I didn't want it to be published until after feedback.

@leviport
Copy link
Member

"Initial setup" is fine, but we need to show the actual setup process. When someone receives a System76 machine with Pop!_OS installed, it will walk them through an install, then reboot, then walk them through gnome-initial-setup. Copying just the installer portion of that other article doesn't actually show the full process, and duplicating content increases maintenance burden.

@jacobgkau
Copy link
Member

Re: not duplicating content, if part of the current installation article is moved into a different article verbatim, those steps should ideally be removed from the old article, and it should link to the new one. (At that point, the old one would be pretty short, so it might make sense to just fold it into the USB creation article? And if the new article's going to be renamed to be about installation, just make the changes to the one this content was copied from instead of making a new article so the URL can stay the same?)

Although I'm pretty sure there are some minor differences setting up a System76 machine via OEM mode vs. installing from a USB. This new article still covers the partitioning screen (TryInstallView), which isn't shown in OEM mode. So really, if this is about System76 computer setup, it can't just be copied from the USB installation article. (And a third-party PC user who didn't install themselves would not see the installer, since the installer runs off of the USB, and this new article cuts out the part about how to boot from the USB.)

@Socialhappiness
Copy link
Contributor Author

Thank you for the feedback! I'm going to rethink it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants