Merge pull request #65 from t0b10-r3tr0/main

Reviewed and updated spelling/grammar on most of the documentation.

Author: chrizzo-hb

docs/configure/bluetooth.md

@@ -20,7 +20,7 @@ After your devices have been paired successfully, you might need to take additio
 
 ### Set up audio output
 
-After pairing an audio output device (like a headphone), you need to set it as your audio output. Press ++"Start"++ to bring up the main menu, head to *System Settings* and choose your Blueooth device as *Audio output*.
+After pairing an audio output device (like a headphone), you need to set it as your audio output. Press ++"Start"++ to bring up the main menu, head to *System Settings* and choose your Bluetooth device as *Audio output*.
 
 ## Forget a Bluetooth device
 

docs/configure/collections.md

@@ -1,6 +1,6 @@
 # :material-collage: Collections
 
-In addition to the systems displayed; EmulationStation (ES) has functionality to create custom collections that you can use to group and organize your game library in different ways.  For example; if you wanted to create a view that automatically grouped all of your Role Playing Games or one that only lists the games you are currently playing you can use ES collections to do that. 
+In addition to the systems displayed, EmulationStation (ES) has functionality to create custom collections that you can use to group and organize your game library in different ways.  For example; if you wanted to create a view that automatically grouped all of your Role-Playing Games or one that only lists the games you are currently playing you can use ES collections to do that. 
 
 All of the options described below can be managed by pressing ++"START"++ anywhere in ES to open the Main Menu and then opening ++"Game Collection Settings"++
 
@@ -17,7 +17,7 @@ Knulli includes a `Now Playing` collection that can be used to curate and play t
     </tr>
 </table>
 
-Once its turned on; you can add to it by pressing ++"X(NORTH)"++ on any game while in ES.  In the menu that opens you'll see `Now Playing` listed under the collections header.  Simply highlight it and press the confirm button.  
+Once it's turned on, you can add to it by pressing ++"X(NORTH)"++ on any game while in ES.  In the menu that opens you'll see `Now Playing` listed under the collections header.  Simply highlight it and press the confirm button.  
 
 You can also set Knulli to boot directly into the Now Playing collection by setting the `Start on System` value in the `Game Collection Settings` menu.  Change that value to `Now Playing` and also turn on `Start on Gamelist`.
 
@@ -33,11 +33,11 @@ EmulationStation has a set of built-in automated collections to easily view your
 
 ### Editable Collections
 
-An editable collection is one that you can specifically curate by hand.  Simply give it a name and then as you are browing your gamelists you can press ++"X(NORTH)"++ on any game and add it to the collection you created.  As an example, you could use this functionality to create a collection for all of your Final Fantasy games and then manually add each FF game to the list.
+An editable collection is one that you can specifically curate by hand.  Simply give it a name and then as you are browsing your gamelists you can press ++"X(NORTH)"++ on any game and add it to the collection you created.  As an example, you could use this functionality to create a collection for all of your Final Fantasy games and then manually add each FF game to the list.
 
 ### Dynamic Collections
 
-A dynamic collection enables you to create a set of filters that will automatically group your games.  For example if you wanted to create a collection that automatically grouped all of your Role Playing Games into a single view; you could create a dynamic collection called RPGs, select a genre filter of Role Playing Games and then save the filter.  Then any time you add a new game with the Role Playing genre it will automatically show up in this collection.
+A dynamic collection enables you to create a set of filters that will automatically group your games.  For example if you wanted to create a collection that automatically grouped all of your Role-Playing Games into a single view; you could create a dynamic collection called RPGs, select a genre filter of Role-Playing Games and then save the filter.  Then any time you add a new game with the Role-Playing genre it will automatically show up in this collection.
 
 <table>
     <tr>
@@ -54,4 +54,4 @@ A dynamic collection enables you to create a set of filters that will automatica
 
 ## Additional Notes
 
-You can also use the ++"Game Collection Settings"++ menu to manage which systems are displayed. Press ++"START"++ anywhere in ES to open the Main Menu and then go to ++"Game Collection Settings"++ > ++"Systems Displayed"++.  In this menu; uncheck the systems you would like to hide and then exit the menu.  ES will then refresh and those systems will be hidden.
+You can also use the ++"Game Collection Settings"++ menu to manage which systems are displayed. Press ++"START"++ anywhere in ES to open the Main Menu and then go to ++"Game Collection Settings"++ > ++"Systems Displayed"++.  In this menu, uncheck the systems you would like to hide and then exit the menu.  ES will then refresh and those systems will be hidden.

docs/configure/controls.md

@@ -26,15 +26,15 @@ Press ++"Start"++ to open the main menu and head to *Controller & Bluetooth Sett
 
 !!! info "Controller assignments are reset after reboot"
 
-    Your KNULLI device does not memorize, which controller was assigned to which player in a previous session. Make sure to always assign all controllers to the corresponding players after you (re-)connected them to your KNULLI device.
+    Your KNULLI device does not memorize which controller was assigned to which player in a previous session. Make sure to always assign all controllers to the corresponding players after you (re-)connected them to your KNULLI device.
 
 ## Controller mapping
 
 !!! danger "Do not attempt to remap the built-in controls"
 
-    Each KNULLI build is **optimized** for the specific device it was designed for. Specificially, all built-in controls are **already mapped** for you. Do **not** attempt to remap the built-in controls in the *Controller & Bluetooth Settings* menu. By doing so, you might **break** any hidden virtual controls (e.g. the **D-pad-to-virtual-stick mapping** for devices without analog sticks, which usually can be toggled with ++"Function"+++++"Select"++). If you want to remap controls for certain *games* or *systems*, please do it within the respective game or emulator settings. The *Controller & Bluetooth Settings* menu is **not** the right place to map game- or system-specific controls!
+    Each KNULLI build is **optimized** for the specific device it was designed for. Specifically, all built-in controls are **already mapped** for you. Do **not** attempt to remap the built-in controls in the *Controller & Bluetooth Settings* menu. By doing so, you might **break** any hidden virtual controls (e.g. the **D-pad-to-virtual-stick mapping** for devices without analog sticks, which usually can be toggled with ++"Function"+++++"Select"++). If you want to remap controls for certain *games* or *systems*, please do it within the respective game or emulator settings. The *Controller & Bluetooth Settings* menu is **not** the right place to map game- or system-specific controls!
 
-To map the buttons and directional inputs of a controller, press the ++"Start"++ button to bring up the main menu, find *Controller & Bluetooth Settings* and select *Controller Mapping*. On-screen instructions will ask you to hold a button on the controller you want to map. Once the controller was detected, you will be guided through the process: Simply press the button on your controller which corresponds best to the button/function displayed on screen.
+To map the buttons and directional inputs of a controller, press the ++"Start"++ button to bring up the main menu, find *Controller & Bluetooth Settings* and select *Controller Mapping*. On-screen instructions will ask you to press and hold a button on the controller you want to map. Once the controller was detected, you will be guided through the process: Simply press the button on your controller which corresponds best to the button/function displayed on screen.
 
 If you press a wrong button, don't worry: You will always be able to return to this menu and remap the controller again.
 

docs/configure/customization/background-music.md

@@ -4,7 +4,7 @@ Your [userdata folder](../../../play/add-games/game-storage) contains a folder c
 
 !!! info "Make sure your music files are compatible"
 
-    Background music for KNULLI/EmulationStation should be in `MP3` or `OGG` format and have a sample rate of 44100Hz and a bitrate of 256kb/s max.
+    Background music for KNULLI/EmulationStation should be in `MP3` or `OGG` format and have a sample rate of 44100Hz and a bit rate of 256kb/s max.
 
 When adding your background music, you can either dump all your songs randomly into the `music` folder or create subfolders for each **system** if you want to add **system-specific music** for all the systems you like to play. If you want to add your music per system, you should **not** leave any music files in the top level of the `music` folder but sort all your music **by system**. The system names in the `music` folder correspond to the system names in the `roms` folder (e.g., `snes` for SNES, `megadrive` for Mega Drive/Genesis).
 

docs/configure/customization/bezel-decorations.md

@@ -21,13 +21,13 @@ Even though most bezel decoration packs are specifically designed for 16:9 displ
 Some bezels which were originally created by [drkhrse](https://github.com/drkhrse) and [antiKk](https://github.com/antiKk) have been adapted by [nvitaterna](https://github.com/nvitaterna) to work on Batocera-based handhelds with 4:3 displays. To install this set on your Knulli device
 
 * download the bezel pack from the GitHub repository of nvitaterna, either by
-    * visting the [GitHub repository](https://github.com/nvitaterna/batocera_4_3_handheld_bezels) and finding *Download ZIP* in the *Local* menu,
+    * visiting the [GitHub repository](https://github.com/nvitaterna/batocera_4_3_handheld_bezels) and finding *Download ZIP* in the *Local* menu,
     * or just clicking [here](https://github.com/nvitaterna/batocera_4_3_handheld_bezels/archive/refs/heads/main.zip).
 * unzip the file (e.g. with [7-Zip](https://7-zip.org/)).
 * find the `batocera_4_3_handheld_bezels` folder **inside** the `decorations` folder you just unzipped.
 * copy the **entire** `batocera_4_3_handheld_bezels` folder into the `decorations` folder of your  [userdata folder](../../../play/add-games/game-storage).
 
-The bezel pack should now be installed and ready to use. However, to apply it, you have to set it up as explained in the [Apply bezel decorations](#apply-bezel-decorations) section.
+The bezel pack should now be installed and ready to use. However, to apply it, you must set it up as explained in the [Apply bezel decorations](#apply-bezel-decorations) section.
 
 ## Apply bezel decorations
 

docs/configure/customization/themes.md

@@ -25,7 +25,7 @@ The following options can be changed directly from the main menu under `User Int
 | Aspect Ratio | Enables you to select the correct aspect ratio for your screen.  This will automatically set itself so you should not need to change it but if the theme layout looks odd or spacing looks incorrect you can use this setting to make sure the aspect ratio matches your screen. | `16:9`, `16:10`, `4:3`, `3:2`, `1:1` |
 | System Artwork | Defines the set of artwork that is displayed on the system view | `Default`, `Noir`, `Custom`, `Custom (Fullscreen)` |
 | System Logos | Defines the logo set used on all views | `Default`, `Custom` |
-| Game Artwork | Defines the type of artwork used to represent a game. These are sourced from the the selections you make in the scraper menu. Image will display the image you selected to scrape for `Image Source`.  Image (Cropped) will display that same image zoomed in to fill the screen.  Boxart will display the image you selected to scrape for `Box Source` | `Image`, `Image (Cropped)`, `Boxart` |
+| Game Artwork | Defines the type of artwork used to represent a game. These are sourced from the selections you make in the scraper menu. Image will display the image you selected to scrape for `Image Source`.  Image (Cropped) will display that same image zoomed in to fill the screen.  Boxart will display the image you selected to scrape for `Box Source` | `Image`, `Image (Cropped)`, `Boxart` |
 | Game Metadata | Sets if metadata (e.g. description, release date, etc...) should be displayed for a game | `On`, `Off` |
 | Font Size | Set the size for text elements throughout the theme. | `Default`, `Small`, `Large` |
 | Color Scheme | Sets the color scheme that is used for the theme.  There is a set of prebuilt color schemes that you can select and an option to supply your custom color scheme (selected by choosing `custom`). You can see details on customizations below under [Customization](#customization). | `Default`, `Light`, `Steam OS`, `SNES`, `Famicom`, `DMG`, `OLED`, `Custom` |
@@ -61,9 +61,9 @@ The artwork used on the system view can be customized with your own images.
 * They can be named:
     * `_default.png`
     * `${system.theme}.png`
-    * The theme will look them them up in that order. If a given image is not found in your folder then the the images from the theme will be used as a fallback.  This allows you to customize only the images you want and still have images displayed for all systems.
+    * The theme will look them up in that order. If a given image is not found in your folder then the images from the theme will be used as a fallback.  This allows you to customize only the images you want and still have images displayed for all systems.
     * `_default.png` can be used for creating a single image that is used for all systems OR a fallback for systems that you did not create a custom image for (if you don't want to use the fallback that already exists in the theme)
-    * `${system.theme}.png` should be named for the system you are looking to override. For example if you wanted to override the artwork for `snes` you would create an image called `snes.png` in the artwork folder.
+    * `${system.theme}.png` should be named for the system you are looking to override. For example, if you wanted to override the artwork for `snes` you would create an image called `snes.png` in the artwork folder.
 * Once your images are in place you turn on custom images by changing the `System Artwork` setting to `Custom`
 
 #### For fullscreen artwork:
@@ -75,9 +75,9 @@ The artwork used on the system view can be customized with your own images.
     * `_default.jpg`
     * `${system.theme}.png`
     * `${system.theme}.jpg`
-    * The theme will look them them up in that order.
+    * The theme will look them up in that order.
     * `_default.png/jpg` can be used for creating a single image that is used for all systems OR a fallback for systems that you did not create a custom image for (if you don't want to use the fallback that already exists in the theme)
-    * `${system.theme}.png/jpg` should be named for the system you are looking to override. For example if you wanted to override the artwork for `snes` you would create an image called `snes.png` or `snes.jpg` in the artwork folder.
+    * `${system.theme}.png/jpg` should be named for the system you are looking to override. For example, if you wanted to override the artwork for `snes` you would create an image called `snes.png` or `snes.jpg` in the artwork folder.
 * Once your images are in place you turn on custom images by changing the `System Artwork` setting to `Custom (Fullscreen)`
 
 #### Splash Screen
@@ -95,7 +95,7 @@ You can create your own custom color scheme to use for the theme
 * Download [this template](https://github.com/anthonycaccese/art-book-next-es/blob/main/resources/customizations/colors.xml)
 * Upload it in the path you created above and make sure its called `colors.xml`
 * Change any values in the template to the colors you prefer.
-* I tried to make the values as self explanatory as possible but if you have questions regarding which property does what please don't hesitate to ask.
+* I tried to make the values as self-explanatory as possible but if you have questions regarding which property does what please don't hesitate to ask.
 * After your colors are defined; in theme configuration change `Color Scheme` to `Custom`
 
 ### Logos
@@ -107,8 +107,8 @@ System logos can be customized by adding your own images
 * They can be named:
     * `${system.theme}.svg`
     * `${system.theme}.png`
-    * The theme will look them them up in that order. If a given image is not found in your folder then the the images from the theme will be used as a fallback.  This allows you to customize only the images you want and still have images displayed for all systems.
-    * `${system.theme}.svg/png` should be named for the system you are looking to override. For example if you wanted to override the logo for `snes` you would create an image called `snes.svg` or `snes.png` in the logos folder.
+    * The theme will look them up in that order. If a given image is not found in your folder then the images from the theme will be used as a fallback.  This allows you to customize only the images you want and still have images displayed for all systems.
+    * `${system.theme}.svg/png` should be named for the system you are looking to override. For example, if you wanted to override the logo for `snes` you would create an image called `snes.svg` or `snes.png` in the logos folder.
 * Once your images are in place you turn on custom images by changing the `System Logos` setting to `Custom`    
 
 ## Adding Additional Themes
@@ -121,4 +121,4 @@ System logos can be customized by adding your own images
 
 ## Creating Your Own Theme
 
-An exhaustive tutorial is out of scope for this wiki.  That said; please see Batocera's theme documention @ [https://wiki.batocera.org/write_themes_for_emulationstation](https://wiki.batocera.org/write_themes_for_emulationstation).  Its a great starter guide for understanding the fundamentals of creating themes for the version of EmulationStation used by Knulli.
+An exhaustive tutorial is out of scope for this wiki.  That said; please see Batocera's theme documentation @ [https://wiki.batocera.org/write_themes_for_emulationstation](https://wiki.batocera.org/write_themes_for_emulationstation).  Its a great starter guide for understanding the fundamentals of creating themes for the version of EmulationStation used by Knulli.