diff --git a/README.md b/README.md
index fab00ddc..de76719b 100644
--- a/README.md
+++ b/README.md
@@ -7,12 +7,15 @@
This repository contains shell components for Plasma Mobile.
-### Links
-* Project page: https://invent.kde.org/plasma/plasma-mobile
-* Documentation: https://invent.kde.org/plasma/plasma-mobile/-/wikis/home
-* Issues relating to the shell: https://invent.kde.org/plasma/plasma-mobile/-/issues
-* General Plasma Mobile issues: https://invent.kde.org/teams/plasma-mobile/issues/-/issues
-* Development channel: https://matrix.to/#/#plasmamobile:matrix.org
+* Project page: [plasma-mobile.org](https://plasma-mobile.org)
+* Respository: [invent.kde.org/plasma/plasma-mobile](https://invent.kde.org/plasma/plasma-mobile)
+* Documentation: [invent.kde.org/plasma/plasma-mobile/-/wikis/home](https://invent.kde.org/plasma/plasma-mobile/-/wikis/home)
+* Development channel: [matrix.to/#/#plasmamobile:matrix.org](https://matrix.to/#/#plasmamobile:matrix.org)
+
+### Reporting issues
+* How to report issues: [invent.kde.org/plasma/plasma-mobile/-/wikis/Issue-Tracking](https://invent.kde.org/plasma/plasma-mobile/-/wikis/Issue-Tracking)
+* Shell issue tracker: [invent.kde.org/plasma/plasma-mobile/-/issues](https://invent.kde.org/plasma/plasma-mobile/-/issues)
+* General issue tracker: [https://invent.kde.org/teams/plasma-mobile/issues/-/issues](https://invent.kde.org/teams/plasma-mobile/issues/-/issues)
### Locations
* [components/mobileshell](components/mobileshell) - private shell component library (API not guaranteed to be stable!)
@@ -21,6 +24,8 @@ This repository contains shell components for Plasma Mobile.
* [look-and-feel](look-and-feel/contents) - Plasma look-and-feel packages (ex. lockscreen, logout, etc.)
* [quicksettings](quicksettings) - quick settings packages for the action drawer
+
+
### Test on a development machine
See the [documentation page](https://invent.kde.org/plasma/plasma-mobile/-/wikis/Building-and-Testing-Locally) for more details.
@@ -35,3 +40,12 @@ To start the phone homescreen in a window, run:
```
QT_QPA_PLATFORM=wayland dbus-run-session kwin_wayland --xwayland "plasmashell -p org.kde.plasma.phoneshell"
```
+
+
+---
+
+
+
+
+
+