AUTO: Sync Zune software setup docs to personal site

docs/portfolio/personal/zune-software-setup/01_getting-started.md

@@ -0,0 +1,21 @@
+# Getting started
+
+Before you begin set up, confirm that you can turn on your Zune device and that is working as expected.
+
+!!! note
+
+    I confirmed that these instructions work when using a Zune HD. If you have an earlier Zune model, you should be able to follow these instructions as well. However, the apps and games can be installed only on a Zune HD.
+
+## Prerequisites
+
+- PC running Windows 10
+
+!!! attention
+
+    In Windows 11, the Zune driver does not automatically install after plugging in the device. I'm currently troubleshooting the issue and will update these instructions after I find and confirm a resolution.
+
+- Zune device
+- Zune charging cable
+- [Notepad++](https://notepad-plus-plus.org/)
+	- We will need to make admin changes to the "hosts" file in Windows. To do this, we will use Notepad++ since the default text editor in Windows may not allow you to make administrator-level changes.
+- Internet connection

docs/portfolio/personal/zune-software-setup/02_installing-the-zune-software.md

@@ -0,0 +1,24 @@
+# Installing the Zune software
+
+Go to [Zune Update - RESOURCES](https://www.zuneupdate.com/resources/). Then, click **ZUNE-SOFTWARE.ZIP**, and specify a folder to save the file to.
+
+Go to the folder where you downloaded the software package to. Right-click **ZUNE-SOFTWARE.ZIP**, and select **Extract All**. 
+
+In the wizard, click **Extract**. After the executable file is extracted and the extracted folder appears, double-click **ZunePackage.exe**.
+
+!!! note
+
+    User Account Control in Windows may prompt you with the message "**Do you want to allow this app to make changes to your device?**" If so, click **Yes**.
+
+Click **Accept** if you accept the the terms of the Microsoft license terms.
+![Microsoft license agreement](https://github.com/josh-wong/zune-software-setup/blob/main/docs/assets/screenshots/microsoft_license_accept.png?raw=true)
+
+In the window "Zune is ready to install", uncheck **Send info about setup to help improve experience**. Then, click **Install**.
+![Zune software installation](https://github.com/josh-wong/zune-software-setup/blob/main/docs/assets/screenshots/zune_software_install.png?raw=true)
+
+!!! note
+
+    During installation, Windows may prompt to install .NET Framework 3.5. If so, click **Download and install this feature**. After installation .NET Framework 3.5 is complete, click **Close**. The Zune software will continue installing.
+
+After the Zune software installation is complete, click **Close**.
+![Zune software installation complete](https://github.com/josh-wong/zune-software-setup/blob/main/docs/assets/screenshots/zune_software_installation_complete.png?raw=true)

docs/portfolio/personal/zune-software-setup/03_connecting-with-the-zune-software.md

@@ -0,0 +1,67 @@
+# Connecting the Zune with the Zune software
+
+After installing the Zune software, we need to add a registry setting in Windows and update the "hosts" file in Windows. This will ensure that your Zune can communicate with the Zune software without encountering errors or freezing.
+
+## Add a registry setting to Windows
+
+Since the Zune software was created and optimized for Windows 7, there seems to be an issue with Windows automatically adding the necessary registry settings. In this step, we will add a setting to the registry in Windows.
+
+Go to **[Zune Update - TOOLS](https://www.zuneupdate.com/resources/tools/)**. Then, click **ZUNE-APP-SETTINGS-REG-FILE.ZIP**, and specify a folder to save the file to.
+
+Go to the folder where you downloaded the ZIP file to. Right-click **ZUNE-APP-SETTINGS-REG-FILE.ZIP**, and select **Extract All**. In the wizard, click **Extract**. A registry file will be extracted.
+
+!!! warning
+
+    If you're worried about the contents of the file and are comfortable checking what will be add to the Windows registry in the next step, you can open the file in Notepad++ to check its contents.
+
+In the extracted folder, double-click **Zune Configure App Settings.reg**.
+
+!!! note
+
+    If Windows prompts you about applying this registry setting, click **Run** to allow the file to be added to your registry.
+
+When the warning appears, click **Yes**.
+![Registry editor warning](https://github.com/josh-wong/zune-software-setup/blob/main/docs/assets/screenshots/registry_editor_warning.png?raw=true)
+
+When the confirmation window appears, click **OK**.
+![Registry editor confirmation](https://github.com/josh-wong/zune-software-setup/blob/main/docs/assets/screenshots/registry_editor_confirmation.png?raw=true)
+
+## Update the "hosts" file in Windows
+
+Since Microsoft decommissioned the server that facilitates communication between the Zune and the Zune software, we need to force the software to recognize the device. We do this by tricking the software into thinking the server is still available.
+
+Open **File Explorer**. Enter **%SystemRoot%\System32\drivers\etc** in the address bar, then click **Enter**.
+
+Right-click **hosts**, click **Open with**, then select **Notepad++**.
+
+At the bottom of the file, add the following to a new line:
+     `66.115.173.227	resources.zune.net`
+
+Save the file.
+
+!!! note
+
+    When saving the file, you may be prompted to launch Notepad++ in administrator mode since the "hosts" file is protected. If so, do the following:
+
+    1. Click **Yes** to open the file in administrator mode.
+    2. Click **Yes** when asked "Do you want to allow this app to make changes to your device?".
+    3. Save the file.
+
+## Connect the Zune device
+
+If you have a PIN code set up on your Zune device, enter the code to unlock the device.
+
+Plug in your Zune device to your computer to automatically install the device driver. Then, open the Zune software.
+
+!!! note
+
+    - **If you previously reset your Zune to its factory default settings**, you will see a different screen that shows your Zune has a "Required Update". If this screen appears, click **Accept**. Once this process is finished, you can begin syncing your media to your Zune HD.
+    - **If the music you have synced on your Zune device is stored on a cloud service** (for example, OneDrive or Google Drive), you may see a window with the message "You haven't made a selection. Is this screen displayed correctly?" You can either wait until your music finishes downloading or you can cancel the files from being downloaded. After that, the Zune software will start from the initial setup screen.
+
+If you want to apply the default settings to the Zune software, click **Start**. Or, if you want to change the default settings, click **Settings**, then follow the screens in the setup wizard.
+![Zune software setup screen](https://github.com/josh-wong/zune-software-setup/blob/main/docs/assets/screenshots/zune_software_setup_screen.png?raw=true)
+
+You've now finished installing the Zune software. If you have any music in the Zune software default folders or the folders that you chose in the setup wizard, those artists, albums, and songs will appear on the main screen.
+![Zune software](https://github.com/josh-wong/zune-software-setup/blob/main/docs/assets/screenshots/zune_software.png?raw=true)
+
+If you want to choose different folders to sync with your Zune device, go to **Settings** in the Zune software. In **Collection**, you will see **Windows Libraries** where you can choose which folders to sync.

docs/portfolio/personal/zune-software-setup/04_adding-apps-and-games.md

@@ -0,0 +1,15 @@
+# Adding apps and games (Zune HD only)
+
+If you have a Zune HD, you can install apps and games on your device. However, many of the apps, especially ones that require connecting to an external service, no longer work because those services have changed their APIs or have been decommissioned. Most of the games should be playable.
+
+Go to **[Zune HD Apps.zip](https://www.dropbox.com/s/rqsifa8ukbkvybb/Zune%20HD%20Apps.zip?dl=0)** on Dropbox. Then, click **Download**, and specify a folder to save the file to.
+
+Go to the folder where you downloaded the ZIP file to. Right-click **Zune HD Apps.zip** and click **Extract All**.
+
+Follow the **Extract Compressed (Zipped) Folders** wizard to extract the files.
+
+Go to **%LOCALAPPDATA%\Microsoft\Zune**. At the top of the **File Explorer** window, click **New** and select **Folder**. Then, name the new folder **Applications**.
+
+In the folder that you extracted the apps and games to, select which ones you want to add to your Zune. Then, move them into the **Applications** folder.
+
+Connect your Zune device and open the Zune software. All the apps and games will automatically sync to your Zune.

docs/portfolio/personal/zune-software-setup/05_conclusion.md

@@ -0,0 +1,3 @@
+# Conclusion
+
+You should now be able to connect your Zune device to the Zune software and sync your media to your Zune. Additionally, you can also customize which folders the software should sync to your device, select which apps and games you want on your device (for Zune HD owners), and even rip and burn CDs.

docs/portfolio/personal/zune-software-setup/06_references.md

@@ -0,0 +1,8 @@
+# References
+
+Microsoft still hosts basic manuals for Zune and Zune HD devices. Please see [Zune Player and Zune HD Player Product Manuals](https://www.microsoft.com/en-us/download/details.aspx?id=30468) to download those manuals.
+
+## Special thanks
+
+- To [Zune Update](https://www.zuneupdate.com/) for providing an IP address that provides the server of reference that we need when connecting a Zune device with the Zune software.
+- To u/BenjaminGordonT on Reddit for providing a Dropbox link to the ZIP file of the Zune HD apps and games: [All the Original Zune HD Apps and Games!](https://www.reddit.com/r/Zune/comments/52yo3h/all_the_original_zune_hd_apps_and_games/)

docs/portfolio/personal/zune-software-setup/07_contributions.md

@@ -0,0 +1,8 @@
+# Contributing
+
+Does this documentation need to be clarified, updated, or otherwise improved upon? If so, pull requests are welcome!
+
+Please do the following:
+
+1. Open an [issue](https://github.com/josh-wong/zune-software-setup/issues) on GitHub and describe what you would like to add or change.
+2. Create a pull request and link to your issue. This will help me track changes to the documentation and help provide context for future reference.

docs/portfolio/personal/zune-software-setup/index.md

@@ -0,0 +1,11 @@
+# How to connect a Zune device to the Zune software
+
+This tutorial describes how to connect a Microsoft Zune device to the Zune software. 
+
+I created this tutorial because syncing your Zune with the Zune software is a bit confusing since Microsoft has removed the software from its site and decommissioned the server for Zune. A few different resources exist that provide the setup files, but no exact instructions on how to:
+
+- Install the Zune software.
+- Sync your Zune device with the Zune software.
+- Optional: Install apps and games onto your Zune HD. 
+
+![Zune HD](https://github.com/josh-wong/zune-software-setup/blob/main/docs/assets/screenshots/zune-hd.jpg?raw=true)

docs/portfolio/personal/zune-software-setup/stylesheets/extra.css

@@ -0,0 +1,8 @@
+:root > * {
+  --md-primary-fg-color:        #080f53;
+  --md-typeset-a-color:         #2a3fff;
+}
+[data-md-color-scheme="slate"] {
+  --md-primary-fg-color:        #080f53;
+  --md-typeset-a-color:         #838fff;
+}