Skip to content

Conversation

m33o44
Copy link

@m33o44 m33o44 commented Sep 24, 2025

Type

  • Rewrite already written documentation

Questions

Describe your pull request

I changed the order of instructions in step 5 of getting-started
1 - 3 were moved after 7 so that the instructions for updating Windows come first
the number in step 4. is removed. The “if” part of the sentence is highlighted and moved to the first position, separate from the other steps

This should make it clearer that Windows should be updated before installing AtlasOS, and the manual driver installation step is separated from the other steps to avoid confusion

installingAtlasOSedit

@github-actions github-actions bot added the getting-started Issues or PRs related to the 'Getting Started' page label Sep 24, 2025
@m33o44 m33o44 changed the title Update installation guide with clearer ISO instructions getting started, step 5 - changed order of instructions for clarity Sep 24, 2025
1. Extract both downloads to your desktop

1. If you have chosen [**Manual Driver Installation**](#driver-updates), run `Disable Drivers Installation in Windows Update.reg` from the extracted Atlas Playbook download and restart
**If you have chosen [**Manual Driver Installation**](#driver-updates)**, run `Disable Drivers Installation in Windows Update.reg` from the extracted Atlas Playbook download and restart
Copy link
Member

Choose a reason for hiding this comment

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

This still says to run the .reg file from the extracted download, before the actual download step.

Copy link
Author

Choose a reason for hiding this comment

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

mb, I'm going to change this soon

Copy link
Member

@whallin whallin left a comment

Choose a reason for hiding this comment

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

I see where you're coming from with the potential unclarity. I do believe though that the better solution for clarity might be to indent the "If you have chosen Manual Drive Installation …"-step under step 3 (Extract both downloads …).

@Ast3risk-ops
Copy link
Contributor

Ast3risk-ops commented Sep 26, 2025

I see where you're coming from with the potential unclarity. I do believe though that the better solution for clarity might be to indent the "If you have chosen Manual Drive Installation …"-step under step 3 (Extract both downloads …).

Or you could make it a title-less admonition @m33o44

!!! info ""
    content

This renders as a box with a coloured border.

@m33o44
Copy link
Author

m33o44 commented Sep 26, 2025

I see where you're coming from with the potential unclarity. I do believe though that the better solution for clarity might be to indent the "If you have chosen Manual Drive Installation …"-step under step 3 (Extract both downloads …).

Or you could make it a title-less admonition @m33o44

!!! info ""
    content

This renders as a box with a coloured border.

That's what I wanted to do first
adding the box after step 6 (extract both downloads to your desktop)

I'm going to change that later today, I've got other things to do rn

changed the "manual driver installation"-part into a note-box after step 6. (extract the files to your desktop)
@m33o44
Copy link
Author

m33o44 commented Sep 26, 2025

How it looks after the recent changes:
grafik

@Ast3risk-ops
Copy link
Contributor

How it looks after the recent changes: grafik

No you should make it title-less (which also means you should use a brighter colour like info).

@m33o44
Copy link
Author

m33o44 commented Sep 26, 2025

How it looks after the recent changes: grafik

No you should make it title-less (which also means you should use a brighter colour like info).

you mean like this:
grafik

@Ast3risk-ops
Copy link
Contributor

How it looks after the recent changes: grafik

No you should make it title-less (which also means you should use a brighter colour like info).

you mean like this: grafik

Yeah. There's no real reason for that box to have a title at all.

the box of "manual driver installation" has been changed
- title has been removed
- color was changed from "note" to "info"
@m33o44 m33o44 requested a review from whallin September 30, 2025 17:06
@m33o44
Copy link
Author

m33o44 commented Oct 4, 2025

How it looks after the recent changes: grafik

No you should make it title-less (which also means you should use a brighter colour like info).

you mean like this: grafik

Now that I'm reading through the new instructions order again, I'm wondering if it even makes sense.
If you're installing your drivers manually, you probably don't want to install them through Windows Update, which would require running the .cmd file before installing the updates through Windows Update

@Ast3risk-ops
Copy link
Contributor

Uh, yeah that's how it's supposed to work.

@m33o44
Copy link
Author

m33o44 commented Oct 4, 2025

then the change of order wouldn't even universally work for the manual driver installation
I'm thinking about adding a tab like the Windows installation with the "no USB Drive" and "USB Drive" method in step 3, but with "automatic driver installation (recommended)" and "manual driver installation"

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
getting-started Issues or PRs related to the 'Getting Started' page
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants