Merge pull request #2148 from hacks-guide/basic-understanding

basic-information.txt

_pages/en_US/basic-information.txt

@@ -0,0 +1,108 @@
+---
+title: "Basic Information"
+---
+
+{% include toc title="Table of Contents" %}
+
+If this is your first time modding a 3DS (or you're unfamiliar with technology), keep reading! Otherwise, if you have prior experience and know what you're doing, go back to [Get Started](get-started).
+{: .notice--info}
+
+This page covers some of the base computer terminology and 3DS-specific information that you should know before following this guide.
+
+Each section is collapsed by default. Click or tap on the name of the section to open it.
+
+## Things about the 3DS
+
+{% capture compat %}
+<summary><strong>3DS/2DS compatibility</strong></summary>
+![]({{ "/images/screenshots/onboarding/compatible.png" | absolute_url }})
+{: .notice--info}
+
+This guide works with every retail device in the Nintendo 3DS family of consoles (including the New 3DS series and the 2DS), regardless of region or firmware.
+{% endcapture %}
+
+<details>{{ compat | markdownify }}</details>
+
+{% capture compat %}
+<summary><strong>Computer compatibility</strong></summary>
+![]({{ "/images/screenshots/onboarding/os.jpg" | absolute_url }})
+{: .notice--info}
+You can follow this guide as long as you are able to download files from the Internet and copy them to your SD card. Depending on your computer/phone/electronic device, you may need to purchase a USB to SD card adapter to allow your computer to read your SD card.
+{% endcapture %}
+
+<details>{{ compat | markdownify }}</details>
+
+{% capture compat %}
+<summary><strong>SD card location, type, and capacity</strong></summary>
+![]({{ "/images/screenshots/onboarding/sdcard.jpg" | absolute_url }})
+{: .notice--info}
+
+The location of the SD card slot and the type of SD card that is accepted depends on the model of your 3DS. More information can be found on [Nintendo's official support page](https://en-americas-support.nintendo.com/app/answers/detail/a_id/271/~/how-to-insert-an-sd-card-or-microsd-card).
+
+
+The 3DS can read SD cards of any capacity (even those larger than 32GB), but the card must be formatted as FAT32 (**not** exFAT or NTFS). You can use one of the following tools to format your SD card, depending on your operating system: [Windows](formatting-sd-(windows)), [macOS](formatting-sd-(mac)), [Linux](formatting-sd-(linux)).
+
+To follow this guide, you'll need an SD card with a capacity of at least **2GB**.
+{: .notice--warning}
+
+If you want, you can check your SD card for errors before following this guide using [H2testw (Windows)](h2testw-(windows)), [F3 (Linux)](f3-(linux)), or [F3XSwift (Mac)](f3xswift-(mac))
+{: .notice--info}
+
+{% endcapture %}
+<details>{{ compat | markdownify }}</details>
+
+{% capture compat %}
+<summary><strong>Potential risks</strong></summary>
+
+By modding your device , you subject it to the remote (but non-zero) possibility of the device being banned from online play or bricked (rendered non-functional). ___Incorrect file placement will NOT brick your device___, but purposely skipping instructions might. Similarly, the last ban wave occurred over five years ago, but there is no guarantee that another one will not occur in the future.
+
+In short: Modding your device is safe, but it's ___your responsibility___ if something goes wrong.
+
+{% endcapture %}
+<details>{{ compat | markdownify }}</details>
+{: .notice--warning}
+
+## Things about your computer or phone
+
+{% capture compat %}
+<summary><strong>Downloading and copying files</strong></summary>
+![]({{ "/images/screenshots/onboarding/github.png" | absolute_url }})
+{: .notice--info}
+
+In this guide, you will copy files that are downloaded on your computer/phone to your 3DS SD card. Many of these files come from GitHub, so refer to the above screenshot if you're unfamiliar with how to download files from there.
+
+{% endcapture %}
+<details>{{ compat | markdownify }}</details>
+
+{% capture compat %}
+<summary><strong>Opening/extracting files</strong></summary>
+![]({{ "/images/screenshots/onboarding/zipfiles.png" | absolute_url }})
+{: .notice--info}
+
+Some of the files that you will be asked to download come in the `.zip` file format, which is used to package multiple files into one file.
+
+When you are told to "copy (file) from (file).zip", that means that you need to open (or "extract") the ZIP file. Inside the ZIP file will be the file you're looking for, after which you can copy it to the specified location on your SD card.
+
+On most operating systems, you can extract files by double-clicking the file. If this doesn't work, you can install a reputable third-party extraction tool like [7-zip](https://7-zip.org/) instead.
+{% endcapture %}
+<details>{{ compat | markdownify }}</details>
+
+{% capture compat %}
+<summary><strong>(Windows only) File extensions</strong></summary>
+![]({{ "/images/screenshots/onboarding/fileext.png" | absolute_url }})
+{: .notice--info}
+
+If your computer is running Windows, file extensions may be hidden by default, which may make it harder to find the files you're looking for. To enable file extensions, follow [these instructions](file-extensions-(windows)).
+{% endcapture %}
+<details>{{ compat | markdownify }}</details>
+
+## Getting help
+
+If you experience an issue while following this guide, there are many ways that you can get help!
+
+- If you have any questions that haven't been answered on this page, their answers might be in the [Pre-Installation FAQ](faq#pre-installation-faq).
+- If you experience an issue while following this guide, you can check the [Troubleshooting](troubleshooting) page for a solution.
+- If the resources we've provided here aren't helping, you can get one-on-one support over at [Nintendo Homebrew on Discord](https://discord.gg/MWxPgEp).
+
+Continue to [Get Started](get-started)
+{: .notice--primary}

_pages/en_US/get-started.txt

@@ -4,6 +4,9 @@ title: "Get Started"
 
 {% include toc title="Table of Contents" %}
 
+If this is your first time modding a 3DS and/or you're unfamiliar with technology, check out [this page](basic-information) for a quick overview of things you may want to know before starting this guide.
+{: .notice--info}
+
 Before starting this guide, we will see if custom firmware is already installed and check the current system version of your device.
 
 #### Section I - CFW Check

_pages/en_US/home.txt

@@ -34,16 +34,6 @@ This guide will:
   + Install various pieces of homebrew software, such as a package installer, save file manager, and a homebrew app store
   + Make critical system file backups that can help avoid bricks (and recover data in the event of one)
 
-## What do I need to know before starting?
-
-* While the risks of bricking have been minimized over the years, **we are not responsible for anything that goes wrong with your device**. Incorrect file placement will not brick your device, but reckless behavior might.
-* This guide is compatible with every retail device in the Nintendo 3DS family of consoles (including the New 3DS series and the 2DS), regardless of region or firmware.
-* While we believe that custom firmware is safe for online use, there have been online network bans in the past, primarily for cheating and suspicious eShop behavior.
-* Following this guide alone should not result in data loss, but SD card corruption is always a possibility. You should make a backup of your SD card contents if you have important data.
-* You will need a working SD card in your 3DS, as well as the ability to write files to the SD card. The 3DS can read SD cards formatted as MBR/FAT32.
-  + You may want to check your SD card for errors using [H2testw (Windows)](h2testw-(windows)), [F3 (Linux)](f3-(linux)), or [F3XSwift (Mac)](f3xswift-(mac)).
-* If you are using Windows to move files to/from the SD card, you may want to [enable file extensions](file-extensions-(windows)) to avoid misnaming files.
-
 ___
 
 ### Continue to [Get Started](get-started)

_pages/en_US/site-navigation.txt

@@ -19,6 +19,7 @@ sitemap: false
 + [A9LH to B9S](a9lh-to-b9s)
 + [BannerBomb3](bannerbomb3)
 + [BannerBomb3 + Fredtool (TWN)](bannerbomb3-fredtool-(twn))
++ [Basic Information](basic-information)
 + [Credits](credits)
 + [Checking for CFW](checking-for-cfw)
 + [Contribute](contribute)