getsolus · EbonJaeger · May 20, 2023 · May 20, 2023 · May 20, 2023 · May 29, 2023
diff --git a/docs/user/editions/budgie/desktop_icons.md b/docs/user/editions/budgie/desktop_icons.md
@@ -0,0 +1,36 @@
+---
+title: Desktop Icons
+summary: Switching to Nemo desktop icons
+---
+
+# Desktop Icons
+
+Budgie supports a few different desktop icons implementations: Budgie Desktop View, Nemo, and DesktopFolder.
+
+As of Solus 4.3, desktop icons are provided by Budgie Desktop View, a barebones implementation created after desktop icon support was removed from Nautilus. Now that Nemo is available in the Solus package repository, users have the option to switch from Budgie Desktop View to Nemo for desktop icons. Using Nemo's implementation will be the default for Solus 4.5 and on for new installations.
+
+## Switching to Nemo
+
+If you don't want to wait and would like to use Nemo for your desktop icons now, heres how you can:
+
+1. In Budgie Desktop Settings, go to the Desktop page on the left and turn off desktop icons, just in case.
+2. Create a file in `~/.config/autostart` named `org.nemo-desktop.desktop`, and into it paste the following:
+```
+[Desktop Entry]
+Type=Application
+Name=Nemo
+Comment=Start Nemo desktop at log in
+Exec=nemo-desktop
+OnlyShowIn=Budgie;
+AutostartCondition=GSettings org.nemo.desktop show-desktop-icons
+X-GNOME-AutoRestart=true
+NoDisplay=true
+```
+3. Run this in a terminal (or set it via Dconf Editor) to tell Budgie to use Nemo for the desktop view: `gsettings set com.solus-project.budgie-wm desktop-type-override nemo`
+4. Uninstall budgie-desktop-view
+5. Log out and back in
+6. Turn Desktop Icons back on in Budgie Desktop Settings if they aren't already enabled.
+
+Make sure you have the package `budgie-desktop-branding-fortitude-plus` installed as well. It contains a few settings overrides to make Nemo Desktop work with conky, Showtime, and desktop_weather.
+
+If you followed these steps, you should now be using Nemo's desktop icons! Yay!
diff --git a/docs/user/editions/budgie/index.md b/docs/user/editions/budgie/index.md
@@ -5,7 +5,7 @@ summary: A quick introduction to the Budgie Edition of Solus
 
 # Budgie Desktop
 
-> TODO: Add Budgie branding image
+![Budgie Desktop Logo](https://raw.githubusercontent.com/BuddiesOfBudgie/budgie-desktop/main/.github/logo.png)
 
 Budgie is the flagship Edition of Solus. It was originally started by Solus and has now been spun off into its own distro-agnostic project. They describe it as:
 
@@ -14,7 +14,8 @@ Budgie is the flagship Edition of Solus. It was originally started by Solus and
 Here are some links related to this project that you may find helpful:
 
 - [Homepage](https://github.com/BuddiesOfBudgie)
-- [News](https://blog.buddiesofbudgie.org/)
+- [News](https://blog.buddiesofbudgie.org/) 
+- [Documentation](https://docs.buddiesofbudgie.org)
 - [Support](https://github.com/BuddiesOfBudgie/budgie-desktop/issues)
 
 [Go to Budgie Configuration](configuration)

diff --git a/docs/user/editions/budgie/tips-and-tricks.md b/docs/user/editions/budgie/tips-and-tricks.md
@@ -9,17 +9,28 @@ summary: Tips and Tricks for Budgie users
 
 Budgie provides multiple shortcuts to make navigating around Budgie faster and easier.
 
-| Keyboard Shortcut                  | Action                                                     |
-| ---------------------------------- | ---------------------------------------------------------- |
-| Alt + F2                           | Open Budgie Run dialog                                     |
-| Alt + F4                           | Kill the active window on the desktop                      |
-| Alt + Tab                          | Open application switcher overlay                          |
-| Shift + Alt + Tab                  | Open application switcher, switch to previous applications |
-| Super (_also Super + S_)           | Open Budgie Menu                                           |
-| Super + A                          | Open Applets section of Raven                              |
-| Super + L                          | Lock the screen                                            |
-| Super + N                          | Open Notifications section of Raven                        |
-| Super + Space (_also Alt + Shift_) | Switch keyboard layouts                                    |
+Keyboard Shortcut | Action
+----- | -----
+Alt + F2 | Open Budgie Run dialog
+Alt + F4 | Kill the active window on the desktop
+Alt + Tab | Open application switcher overlay
+Shift + Alt + Tab | Open application switcher, switch to previous applications
+Super | Open Budgie Menu
+Super + A | Open Applets section of Raven
+Super + L | Lock the screen
+Super + N | Open Notifications section of Raven
+Super + Space (*also Alt + Shift*) | Switch keyboard layouts
+Super + Shift + P | Open Power Dialog
+
+## Panel Applets
+
+Panel applets can be managed in Budgie Desktop Settings by clicking on the panel you wish to manage in the menu on the left. From this page, you can rearrange the applets that are currently running, remove applets from the panel, or add installed applets to the panel. Some applets have settings that you can also configure from this page by clicking on an applet in the list.
+
+Extra applets are available in the Solus package repository.
+
+## Raven Widgets
+
+Budgie 10.7 introduced Raven widgets. These are very similar to panel applets, but in Raven. The same options that you have with panel applets also exist for Raven widgets. Open Budgie Desktop Settings and click the Raven tab on the left to configure your Raven widgets.
 
 ## Restoring Panel Defaults
 
@@ -30,5 +41,3 @@ budgie-panel --reset --replace &
 ```
 
 After this you can press CTRL + D to close the terminal without closing the Budgie Panel process.
-
-> TODO: There's got to be more that we can add here