dwyl / dev-setup

✈️ A quick-start guide for new engineers on how to set up their Dev environment
81 stars 21 forks source link

Setup Your Mac! #67

Open nelsonic opened 1 month ago

nelsonic commented 1 month ago

@davcsj please read through this repo and confirm you are able to setup your MacBook with the editor etc. If you would like to add a brief section on GitHub Desktop https://github.com/apps/desktop please go ahead.

Your objective is:

When you hit a "wall" (i.e. an obstacle you cannot overcome) the first thing you should do is comment on this issue describing the problem. With a screenshot where relevant. https://www.take-a-screenshot.org/mac.html 🍏 πŸ“· Once you have commented, you can practice your Google skills attempting to solve it. πŸ” If you are still stuck after 10 minutes, drop another comment "I searched for X, but didn't find the solution". πŸ€·β€β™‚οΈ Then you can tap @MikeRund on the shoulder and ask him for help. πŸ™ If after 10 mins You + Mike cannot overcome the obstacle, comment again: "@MikeRund and I couldn't not figure out X ..." Then you can ask me and I'll be very glad to help! πŸ§‘β€πŸ’» πŸ₯·

The point of this exercise is independent learning and problem solving but with a "Safety Net". πŸ•ΈοΈ The more you comment, the more questions you ask, the faster you will learn. 🏁

davcsj commented 1 month ago

I am looking at this repo now, thank you.

davcsj commented 1 month ago

My obsticle is that I don't know how to install Vscode/Vscodium. I am using google to find a solution.

nelsonic commented 1 month ago

Please confirm if VSCode is compatible with your version of macOS. See: https://support.apple.com/en-us/109033 (Share the version in a comment here and then ask Google)

davcsj commented 1 month ago

My issue is that I am not sure from where I can download/install VSCode/Vscodium. I clicked the "download latest version" button on the website: vscodium.com, however it opens a GitHub page where I see many links and I am not sure which one to use. I am curious to know how to install it and what it will look like once installed, so I am using google to find out how.

nelsonic commented 1 month ago

Did you try: https://code.visualstudio.com/download ? πŸ’­

nelsonic commented 1 month ago

Thanks for the reminder that we need to update the Text Editor section in the README.md: https://github.com/dwyl/dev-setup/blob/a3ef632dd90906be5dcab5c509633364ac79160a/readme.md#text-editor It currently recommends Atom but sadly, MSFT have discontinued it ... πŸ€¦β€β™‚οΈ

nelsonic commented 1 month ago

As @MikeRund correctly says, just Googling for "how to install X" will usually give you decent instructions. Often ones I have written: https://stackoverflow.com/questions/10075990/upgrading-node-js-to-the-latest-version/12570971#12570971 πŸ˜‰

nelsonic commented 1 month ago

@davcsj please please please capture what you learn along the way by sharing the links to the videos you watch and articles you read as comments in this issue. πŸ™

davcsj commented 1 month ago

I have downloaded TOTP Authenticator to my phone in order to scan the QR code for the 2 Factor Authentication

nelsonic commented 1 month ago

In the past we've used Google Authenticator on Android: https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2&hl=en&pli=1 image

TOTP looks good: https://play.google.com/store/search?q=totp+authenticator&c=apps&hl=en image

However ... not sure who binaryboot are ... πŸ€·β€β™‚οΈ Don't know if I would trust them with my 2FA ... πŸ’­ https://www.binaryboot.com/totp-authenticator

image

Perhaps we need to specify in this doc which App we recommend people to use. Even if it has worse reviews.

On iOS we typically use Authy: https://apps.apple.com/us/app/twilio-authy/id494168017

image

It's available on Android too: https://play.google.com/store/apps/details?id=com.authy.authy&hl=en image

It appears as though the audience of people on Android are more harsh on Authy in their Play Store reviews ... πŸ’­

davcsj commented 1 month ago

I am new to the terminal so reading through this list of useful commands: https://www.codecademy.com/article/command-line-commands

davcsj commented 1 month ago

I am new to Test Driven Development (TDD) so reading through this tutorial https://github.com/dwyl/learn-tdd

nelsonic commented 1 month ago

@davcsj please LMK if you get stuck. πŸ‘Œ

davcsj commented 1 month ago

I have watched this YT tutorial from 5:56 onwards as listed in the further resources in order to understand the concepts better https://www.youtube.com/watch?v=UZy1Dj9JIg4&t=356s

davcsj commented 1 month ago

Watching this tutorial listed on the resources inside learn TDD https://www.youtube.com/watch?v=qMkV_TDdDeA&t=52s

cristianofromagio commented 1 month ago

My guess is because Authy was involved recently in a security breach [ref. 1].

I've used Google Authenticator before and then migrated to Authy after I lost my phone and couldn't get my 2FA tokens from Google Authenticator because they didn't backup your configs. Yes, Google Authenticator don't backup your configs to your Google account (like they do with any other user data on the phone, but I digress) they also don't support exporting your existing codes, so you have to manually setup each provider again. I picked Authy next because they at least provided backup and sync (although requiring an account).

The most popular replacement for Authy people I know migrated to are 2FAS, Aegis Authenticator and Bitwarden Authenticator. I also migrated from Authy.

d4vcsj commented 4 days ago

generating a new SSH key: https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent

d4vcsj commented 4 days ago

Had to change GitHub Username as TOTP removed from Smartphone. This is my new username. I have followed all the steps in the OP and have my Mac setup. Have cloned the Todo List Tutorial and am following it now.