docs: English wiki

Task: MIL-003#3
2026-10-14 21:31:42 +08:00
parent a24e7cce6f
commit 0ccd21d23d
6 changed files with 186 additions and 0 deletions
@@ -0,0 +1,50 @@
+**English** · [Dansk](Usage-da) · [Bahasa Malaysia](Usage-ms)
+
+# Usage
+
+Start the program with the virtual environment active:
+
+```bash
+python -m password_manager
+```
+
+The program keeps its data in `data.json` in the folder you start it from.
+
+## Generate and add a password
+
+1. Type the website.
+2. Press **Generate Password**. A password is filled in and copied to the
+   clipboard.
+3. Check the e-mail address and press **Add**. Confirm the dialog and the entry
+   is saved.
+
+![The main window after Generate Password](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/030-password-manager/raw/branch/main/docs/images/main-window.png)
+
+![The confirmation before an entry is saved](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/030-password-manager/raw/branch/main/docs/images/add-confirmation.png)
+
+Leaving a field empty shows a warning and saves nothing.
+
+## Search
+
+Type a website and press **Search**. The saved e-mail address and password are
+shown.
+
+![Search finds a saved website](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/030-password-manager/raw/branch/main/docs/images/search-found.png)
+
+If nothing is saved for the website, or no data file exists yet, a message says
+so.
+
+![Search for an unknown website](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/030-password-manager/raw/branch/main/docs/images/search-not-found.png)
+
+## The data file
+
+`data.json` holds one record per website:
+
+```json
+{
+    "example.com": {
+        "email": "jens@example.com",
+        "password": "Sample#Pass123"
+    }
+}
+```