feat: add READMEs to all folders

Signed-off-by: Owen-sz <owen@fyralabs.com>
2026-06-14 15:40:44 +00:00 · 2026-06-14 07:23:20 -05:00
parent 6fe96bbc81
commit b520bf0f42
38 changed files with 147 additions and 0 deletions
@@ -0,0 +1,5 @@
+# Terra apps Folder
+
+This folder is for all graphical-first, general purpose applications.
+Any packages that have a graphical subpackage, or have a more specific purpose that better matches a different folder (for example, zed or veracrypt), should be placed in a more specific folder.
+Use your best judgement.
@@ -0,0 +1,3 @@
+# Terra buildsys Folder
+
+This folder is for all build systems (buildsys).
@@ -0,0 +1,3 @@
+# Terra desktops Folder
+
+This folder is for all desktop environments, wayland compositors, and any related packages.
@@ -0,0 +1,3 @@
+# Terra desktops/budgie Folder
+
+This folder is for all Budgie related packages.
@@ -0,0 +1,3 @@
+# Terra desktops/elementary Folder
+
+This folder is for all elementary related packages.
@@ -0,0 +1,3 @@
+# Terra desktops/gnome Folder
+
+This folder is for all gnome related packages.
@@ -0,0 +1,3 @@
+# Terra desktops/hyprland Folder
+
+This folder is for all hyprland related packages.
@@ -0,0 +1,3 @@
+# Terra desktops/kde Folder
+
+This folder is for all kde related packages.
@@ -0,0 +1,3 @@
+# Terra desktops/lomiri-unity Folder
+
+This folder is for all lomiri-unity related packages.
@@ -0,0 +1,3 @@
+# Terra desktops/mate Folder
+
+This folder is for all mate related packages.
@@ -0,0 +1,3 @@
+# Terra desktops/niri Folder
+
+This folder is for all niri related packages.
@@ -0,0 +1,3 @@
+# Terra desktops/singularity Folder
+
+This folder is for all singularity related packages.
@@ -0,0 +1,3 @@
+# Terra desktops/stardust Folder
+
+This folder is for all stardust XR related packages.
@@ -0,0 +1,3 @@
+# Terra desktops/sway Folder
+
+This folder is for all sway related packages.
@@ -0,0 +1,3 @@
+# Terra desktops/waylands Folder
+
+This folder is for all wayland compositor/tiling window manager related/enhancing packages.
@@ -0,0 +1,9 @@
+# Terra devs Folder
+
+This folder is for developer related packages.
+
+Examples:
+
+- Terminals
+- IDEs/editors
+- Shells
@@ -0,0 +1,3 @@
+# Terra fonts Folder
+
+This folder is for all fonts/font related packages.
@@ -0,0 +1,3 @@
+# Terra games Folder
+
+This folder is for all games/game related packages.
@@ -0,0 +1,5 @@
+# Terra langs Folder
+
+This folder is for all language-specific packages.
+This mostly includes software written for a specific language (language servers, language specific libraries/modules, languages themselves), but may also include software written in a specific language that does not fit anywhere else (for example, all our Haskell ghc-* packages).
+Use your best judgement when contributing here.
@@ -0,0 +1,3 @@
+# Terra langs/crystal Folder
+
+This folder is for all crystal packages.
@@ -0,0 +1,3 @@
+# Terra langs/d Folder
+
+This folder is for all d packages.
@@ -0,0 +1,3 @@
+# Terra langs/go Folder
+
+This folder is for go specific or misc go packages.
@@ -0,0 +1,3 @@
+# Terra langs/haskell Folder
+
+This folder is for all haskell packages.
@@ -0,0 +1,3 @@
+# Terra langs/holyc Folder
+
+This folder is for holyc/holyc related packages.
@@ -0,0 +1,3 @@
+# Terra langs/kotlin Folder
+
+This folder is for all kotlin packages.
@@ -0,0 +1,3 @@
+# Terra langs/lua Folder
+
+This folder is for all lua packages.
@@ -0,0 +1,3 @@
+# Terra langs/nim Folder
+
+This folder is for nim specific or misc nim packages.
@@ -0,0 +1,3 @@
+# Terra langs/python Folder
+
+This folder is for python specific, python modules, or misc python packages.
@@ -0,0 +1,3 @@
+# Terra langs/rust Folder
+
+This folder is for rust specific, or misc rust packages.
@@ -0,0 +1,3 @@
+# Terra langs/vala Folder
+
+This folder is for vala packages.
@@ -0,0 +1,3 @@
+# Terra langs/zig Folder
+
+This folder is for zig specific, or misc zig packages.
@@ -0,0 +1,9 @@
+# Terra langs Folder
+
+This folder is for all library/library related packages.
+
+Examples:
+- C/CPP/etc. header/library first packages
+- GUI frameworks
+- API packages
+- QT packages.
@@ -0,0 +1,4 @@
+# Terra misc Folder
+
+This folder is for all miscellaneous packages that do not fit in any other folders.
+Use your best judgement when contributing here.
@@ -0,0 +1,9 @@
+# Terra multimedia Folder
+
+This folder is for all multimedia packages.
+
+Examples:
+
+- Codecs
+- Media manipulation tools
+- Media explorers
@@ -0,0 +1,11 @@
+# Terra system Folder
+
+This folder is for all system related packages.
+
+Examples:
+
+- Kernel modules
+- Package managers
+- Schedulers
+- udev rules
+- Tools to interact directly with the system (ex. asusctl)
@@ -0,0 +1,3 @@
+# Terra terra Folder
+
+This folder is for all terra related packages.
@@ -0,0 +1,3 @@
+# Terra themes Folder
+
+This folder is for all theme/theme related packages.
@@ -0,0 +1,5 @@
+# Terra tools Folder
+
+This folder is for all tool packages.
+Generally speaking, these are CLI programs with a specific purpose.
+Use your best judgement when contributing here.