Skip to content

POC: Add info about screenshot app on MacOS (without graphics)#47

Open
Miwoli wants to merge 1 commit intos-thom:mainfrom
Miwoli:macos-finder
Open

POC: Add info about screenshot app on MacOS (without graphics)#47
Miwoli wants to merge 1 commit intos-thom:mainfrom
Miwoli:macos-finder

Conversation

@Miwoli
Copy link

@Miwoli Miwoli commented Jul 19, 2025

The current MacOS instruction is missing the easiest way (in my opinion), that uses Spotlight to opend a screenshot app, that gives a lot of options without a hustle to remember a really weird keyboard combo.

Here's a suggestion to add that to the current insturction. In this PR the diagrams are missing, but I'll leave adding them for somebody with the Illustrator

Signed-off-by: Miwoli <miwoli98@gmail.com>
Copy link

@kszczepanskidev kszczepanskidev left a comment

Choose a reason for hiding this comment

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

  1. The instruction is also missing option to capture selection directly into pasteboard by adding Control to Cmd + Shift + 4 shortcut.
  2. The screenshot app also allow screen recording, so following Windows instruction format, there should be separate paragraph added for that

<div class="step-half step-text">
<h2 class="step-title">1</h2>
<p>
Press the <kbd>Command</kbd> + <kbd>Space</kbd> to open Spotlight

Choose a reason for hiding this comment

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

You can open screenshot app with Cmd + Shift + 5

Copy link
Owner

Choose a reason for hiding this comment

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

I think the Spotlight instructions would be good for a note, with the main paragraph being the keyboard shortcut that @kszczepanskidev mentioned.

Suggested change
Press the <kbd>Command</kbd> + <kbd>Space</kbd> to open Spotlight
Press the <kbd>Command</kbd>, <kbd>Shift</kbd>, and <kbd>5</kbd> keys.
</p>
<p>
Note: You can also open the Screenshot app by searching for "Screenshot" in Spotlight. You can open Spotlight by pressing the <kbd>Command</kbd> and <kbd>Space</kbd> keys.

@s-thom s-thom self-assigned this Jul 24, 2025
@s-thom
Copy link
Owner

s-thom commented Jul 24, 2025

Hey, sorry it's taking me a while to get to this, things are pretty busy for me right now. I'll try and get to this as soon as I can 😄

Copy link
Owner

@s-thom s-thom left a comment

Choose a reason for hiding this comment

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

Neat! I had no idea MacOS had the Screenshot app. It seems like it's been around for a long time too.

I've suggested some changes here, both to the content itself and the writing style. I do appreciate the effort taken to try and make it fit in with the rest of the site 😄

Don't worry about not making illustrations at this stage. At some point I want to go through and redo them all anyway (or pay someone I know to do them because it's actually a fair amount of work).

</article>
<article>
<section class="intro">
<h1 class="intro-title">Using screenshot app</h1>
Copy link
Owner

Choose a reason for hiding this comment

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

I don't have a style guide for the writing of this website, but I do want to keep it in a similar style to what it already has.

Note that these suggestions might need to be formatted in your editor as I can't run Prettier in a GitHub comment.

Suggested change
<h1 class="intro-title">Using screenshot app</h1>
<h1 class="intro-title">Using the Screenshot app</h1>

The Screenshot app is referred to with a capital letter in Apple's documentation.

Comment on lines +310 to +311
MacOS has also build-in screenshot app, that let's you select a part
of a screen, a particular window, or even create a screen record
Copy link
Owner

Choose a reason for hiding this comment

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

Suggested change
MacOS has also build-in screenshot app, that let's you select a part
of a screen, a particular window, or even create a screen record
MacOS has a built-in app for taking screenshots and screen recordings.

<div class="step-half step-text">
<h2 class="step-title">1</h2>
<p>
Press the <kbd>Command</kbd> + <kbd>Space</kbd> to open Spotlight
Copy link
Owner

Choose a reason for hiding this comment

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

I think the Spotlight instructions would be good for a note, with the main paragraph being the keyboard shortcut that @kszczepanskidev mentioned.

Suggested change
Press the <kbd>Command</kbd> + <kbd>Space</kbd> to open Spotlight
Press the <kbd>Command</kbd>, <kbd>Shift</kbd>, and <kbd>5</kbd> keys.
</p>
<p>
Note: You can also open the Screenshot app by searching for "Screenshot" in Spotlight. You can open Spotlight by pressing the <kbd>Command</kbd> and <kbd>Space</kbd> keys.

Comment on lines +322 to +327
<section class="step">
<div class="step-half step-text">
<h2 class="step-title">2</h2>
<p>Type in "Screenshot" and open the "Screenshot" app</p>
</div>
</section>
Copy link
Owner

Choose a reason for hiding this comment

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

If accepting the suggestion from above, then step 2 is no longer necessary. You'll also need to re-number any future steps (just pointing it out because this was a mistake I have made while making changes to the site before).

Comment on lines +332 to +335
From the menu-bar select the mode (full-screen, window or partial)
and click capture to take a screenshot. From that bar you can also
set, if you want your screenshot to be saved or to be copied to
the clipboard
Copy link
Owner

@s-thom s-thom Aug 4, 2025

Choose a reason for hiding this comment

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

This is a lot of text for a single paragraph. Generally text on this site is short and quite technical. I think this is long because the process has two different steps in it. The first step is to select the options (full screen, window, partial, where to save), while the second step is the act of clicking the Capture button.

I'd recommend splitting this into two steps, with the first being:

Select whether you want a full screen, window, or partial capture.

Note: You can choose where your screenshot is saved in the Options menu.

and second step:

Click the Capture button.

</p>
</div>
</section>
</article>
Copy link
Owner

Choose a reason for hiding this comment

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

Instructions for screen recordings have been missing from the MacOS page for some time, and it seems the Screenshot app can do them. It's probably woth adding a new <article> block with pretty much these exact same steps. Instead of selecting full screen, window, or partial before clicking the Capture button, you'd be selecting one of the screen recording options instead.

The page for Windows has a "Video recording" section at the bottom which is similar to this.

@s-thom
Copy link
Owner

s-thom commented Aug 4, 2025

@kszczepanskidev

  1. The instruction is also missing option to capture selection directly into pasteboard by adding Control to Cmd + Shift + 4 shortcut.

Oh cool, that's a neat trick. Does that also work for Command + Shift + 3?

@kszczepanskidev
Copy link

@kszczepanskidev

  1. The instruction is also missing option to capture selection directly into pasteboard by adding Control to Cmd + Shift + 4 shortcut.

Oh cool, that's a neat trick. Does that also work for Command + Shift + 3?

Yes, works for both 3 and 4 shortcuts

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.

3 participants