Update package management based on feedback.

getsolus · Aug 14, 2024 · 21fcffd · 21fcffd
1 parent e25814a
commit 21fcffd
Show file tree

Hide file tree

Showing 2 changed files with 25 additions and 25 deletions.
diff --git a/docs/user/package-management/history-and-rollback.md b/docs/user/package-management/history-and-rollback.md
@@ -9,15 +9,6 @@ Solus offers a feature to view your history of software changes and revert your
 
 You can use this feature if you have issues after installing packages or system updates, and you need to return to a working state.
 
-:::warning[Important]
-
-The rollback operation only works if:
-
-- The Solus repository has the version of the package you need.
-- You have a local copy of the package.
-
-:::
-
 ## History of software changes
 
 - To see your history of software changes, open a terminal and execute:
@@ -32,28 +23,37 @@ The rollback operation only works if:
 
 ## Rollback
 
+:::warning[Important]
+
+Reverting software changes only works if:
+
+- The Solus repository has the version of the package you need.
+- You have a local copy of the package.
+
+:::
+
 1. Disable any [local repository](https://help.getsol.us/docs/packaging/advanced-config/local-repository#disabling-the-local-solbuild-repository-in-eopkg) you have.
 
     Local repositories can cause errors during rollbacks.
 
 1. Open a terminal.
 
-1. Check the operation history.
+1. View the history of software changes:
 
     ```bash
     sudo eopkg history
     ```
 
-1. Note the number of the operation you want to undo.
+1. Note the number of the most recent software change.
 
-1. Do the rollback
-
-    1. Use the following command:
+1. Go back to the desired state:
 
     ```bash
     sudo eopkg history -t NUMBER
     ```
 
-    Replace `NUMBER` with the operation number immediately before the one you want to undo.
+    Replace `NUMBER` with a number lower than the latest software change.
+
+    For example, if you want to revert operation 100, use 99 as the number.
 
-    For example, if you want to undo operation 100, use 99 as the number.
+After reverting to the desired state, verify your system status. You might need to restart your system to see some of the changes.
diff --git a/docs/user/package-management/repo-management.md b/docs/user/package-management/repo-management.md
@@ -27,12 +27,12 @@ Before updating, check the [#solus-packaging](https://matrix.to/#/#solus-packagi
 ## Repository management commands
 
 The following table lists the `eopkg` commands you can use to manage your software sources.
-
-| Action                                 | Command                        | Example                                                                   | Notes                                                    |
-| -------------------------------------- | ------------------------------ | ------------------------------------------------------------------------- | -------------------------------------------------------- |
-| Add a repository                       | `sudo eopkg add-repo Name URL` | `sudo eopkg add-repo Example https://example.com/repo/eopkg-index.xml.xz` | This doesn't enable the repository.                      |
-| Remove a repository                    | `sudo eopkg remove-repo Name`  | `sudo eopkg remove-repo Example`                                          | -                                                        |
-| Enable a repository                    | `sudo eopkg enable-repo Name`  | `sudo eopkg enable-repo Example`                                          | -                                                        |
-| Disable a repository                   | `sudo eopkg disable-repo Name` | `sudo eopkg disable-repo Example`                                         | -                                                        |
-| Update a repository                    | `sudo eopkg update-repo Name`  | `sudo eopkg update-repo Example`                                          | You can update all repositories by not providing a name. |
-| List repositories added to your system | `eopkg list-repo`              | `eopkg list-repo`                                                         | -                                                        |
+| Action                                 | Command                        | Example                                                                   |
+| -------------------------------------- | ------------------------------ | ------------------------------------------------------------------------- |
+| Add a repository                       | `sudo eopkg add-repo NAME URL` | `sudo eopkg add-repo Example https://example.com/repo/eopkg-index.xml.xz` |
+| Remove a repository                    | `sudo eopkg remove-repo NAME`  | `sudo eopkg remove-repo Example`                                          |
+| Enable a repository                    | `sudo eopkg enable-repo NAME`  | `sudo eopkg enable-repo Example`                                          |
+| Disable a repository                   | `sudo eopkg disable-repo NAME` | `sudo eopkg disable-repo Example`                                         |
+| Update a repository                    | `sudo eopkg update-repo NAME`  | `sudo eopkg update-repo Example`                                          |
+| Update all repositories                | `sudo eopkg update-repo`       | `sudo eopkg update-repo`                                                  |
+| List repositories added to your system | `eopkg list-repo`              | `eopkg list-repo`                                                         |