From aac0bc4c9f2505249a7e5e9a2e729ec242dc3dd6 Mon Sep 17 00:00:00 2001 From: Owen-sz Date: Fri, 21 Nov 2025 01:44:05 -0600 Subject: [PATCH 01/16] feat(terra): add devcontainer usage, clarify some stuff Signed-off-by: Owen-sz --- pages/terra/contributing.mdx | 69 ++++++++++++++++++++++++++---------- 1 file changed, 51 insertions(+), 18 deletions(-) diff --git a/pages/terra/contributing.mdx b/pages/terra/contributing.mdx index 8f5f26df..fe915d8c 100644 --- a/pages/terra/contributing.mdx +++ b/pages/terra/contributing.mdx @@ -15,7 +15,7 @@ See the following guide for creating a new package yourself. Quick and easy. It's also ok to **suggest packages** to include into Terra, though it might take a while. (We're busy!) Remember, it takes effort to create a package. If you ever need help, hop into -[our Discord server](https://discord.gg/5fdPuxTg5Q) and we will try to help you. +[our Discord server](https://fyralabs.com/discord) and we will try our best to help you. ## Creating a package @@ -27,21 +27,45 @@ Remember, it takes effort to create a package. If you ever need help, hop into ### Preparation -- Install [Andaman] on your system and its mock configs +#### Fedora/Ultramarine + +- Install [Andaman] and its mock configs on your system - `sudo dnf install terra-mock-configs{:ansi}` via Terra - anda is also available via rust crates.io - If on an atomic system, this command works using podman: `podman run --rm --cap-add=SYS_ADMIN --privileged --volume ./:/anda --volume mock_cache:/var/lib/mock --workdir /anda ghcr.io/terrapkg/builder:frawhide anda` -- Use `rust2rpm` for **Rust** packages -- Use `pyp2rpm` for **Python** packages -- Use `go2rpm` for **Go** packages -- else, find the source of the packages you are adding, preferably a URL to a `.tar.gz` archive - - multiple archives are ok - - non `.tar.gz` archives are also ok, but might require additional build dependencies - - we also prefer archives from git repositories +- Fork the [Terra sources repo](https://github.com/terrapkg/packages), and then `git clone` your fork. +- You are now ready for the Writing Sources section below. + +#### Dev container + +You can create, build, and push a package all from within our Dev Container. +This means you do NOT need to be running Fedora/Ultramarine to create a package. +You can run this devcontainer from Linux, macOS, or Windows. + +- Assuming you are using Visual Studio Code, Open Visual Studio Code and navigate to the Extensions menu located at the bottom of the left hand side bar. +- Install the [Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) extension. + +- Fork the [Terra sources repo](https://github.com/terrapkg/packages), and then `git clone` your fork. +- Open this folder in Visual Studio Code (File -> Open Folder). +- It should prompt you to `reopen in Dev Container.` If not, press `Ctrl` + `Shift` + `P` and type `Open Folder in Container...` and select `Dev Container: Open Folder in Container...` and select your cloned Terra fork's folder. + +- You are now in the Terra Dev Container. +- You now have all the packages and configuration necessary to start building packages! + +#### Language support + +The most common languages you will see: +- RPMSPEC (`.spec`), for the package build scripts +- rhai, for the auto-update scripts +- hcl, for informing `anda` of the package +- xml, for appstream metainfo on some packages + +VSCode should prompt you to install these extensions, and Zed should auto-install them. +If not/using a different IDE, we suggest installing language support for each of these. ### Writing sources -1. Fork/clone the [Terra sources repo](https://github.com/terrapkg/packages). +1. Fork the [Terra sources repo](https://github.com/terrapkg/packages), and then `git clone` your fork. 1. Create a folder named after the package name, for example: - A font named `lovelyfonttype` would go in `anda/fonts/lovelyfonttype`. - A Pantheon DE package would go in `anda/desktops/elementary/`. @@ -66,10 +90,17 @@ Remember, it takes effort to create a package. If you ever need help, hop into - It is a custom file format for RPM packages. - This [RPM Packaging Guide] might help newbies with no prior experiences with RPM specs. - This [Spec file format] docs goes into the details of the spec file format. + - You could use `rust2rpm` for **Rust** packages. + - You could use `pyp2rpm` for **Python** packages. + - You could use `go2rpm` for **Go** packages. + - else, find the source of the packages you are adding, preferably a URL to a `.tar.gz` archive + - multiple archives are ok + - non `.tar.gz` archives are also ok, but might require additional build dependencies + - we also prefer archives from git repositories #### Editing the Spec file -> TIP: Check out other spec files for other packages for some examples ;) +> TIP: Check out other spec files of related packages for some examples ;) A generic spec file looks like this: @@ -83,8 +114,8 @@ Source0: https://github.com/some/repo/archive/%{version}.tar.gz # You should change the above link to the source tarball you got from the preparation section License: MIT BuildRequires: some dependencies >= 3.2.1 another-dep -Requires: deps here -# We *highly* encourage you to add yourself as the packager here: +Requires: runtime deps here +# We require you to add yourself as the packager here (if this is an issue for you, let us know): Packager: Your Name %description @@ -102,7 +133,8 @@ echo "this will run when building pkg" echo "this will also run when building pkg but for installing it into %{buildroot} so that anda (mock) can package it" %files -/usr/bin/pkgname-binary +# This macro expands to `/usr/bin`. To see what macros expand to, you can run `rpm --eval %{MACRO}` +%{_bindir}/pkgname-binary /path/to/more/files/*/package %changelog @@ -132,7 +164,7 @@ echo "this will also run when building pkg but for installing it into %{buildroo ## Building -- Having anda installed, run the following command: +- Having anda installed (or in the Dev Container) run the following command: ```ansi anda build -c terra-rawhide-x86_64 anda/fonts/lovelyfonttype-fonts/pkg @@ -143,15 +175,16 @@ up a container), add `--rpm-builder=rpmbuild`. Remember to install the build dependencies using `sudo dnf builddep path/to/pkgname.spec{:ansi}`! - You don't need to create `pkg`. It's not supposed to exist, just needs to be at the end of the build command -- Modify the architecture to match your machine (`x86_64`, `aarch64`) +- Modify the architecture to match your machine (`x86_64`, `i386`, `aarch64`) +- If needed (404 errors when buildong off `rawhide`, you can also modify the version it builds on (`43`, `43`, `el10`, etc.) - If the package fails to build, fix your spec file accordingly - Usually the actual useful error message can be found before the Python traceback (from mock). -- The built RPM will be inside `anda-build/` +- The built RPM(s) will be inside `anda-build/` ## Done? - Git commit and push; remember you must sign your commits! -- Create a pull request that merges to the `main` branch +- Create a pull request that merges to the `frawhide` branch ## Automatic updates From a07c4806424ac55b617dd4f915e9f3f13ee6440c Mon Sep 17 00:00:00 2001 From: Owen-sz Date: Fri, 21 Nov 2025 01:47:54 -0600 Subject: [PATCH 02/16] C Signed-off-by: Owen-sz --- pages/terra/contributing.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/terra/contributing.mdx b/pages/terra/contributing.mdx index fe915d8c..12b4ed03 100644 --- a/pages/terra/contributing.mdx +++ b/pages/terra/contributing.mdx @@ -36,7 +36,7 @@ Remember, it takes effort to create a package. If you ever need help, hop into - Fork the [Terra sources repo](https://github.com/terrapkg/packages), and then `git clone` your fork. - You are now ready for the Writing Sources section below. -#### Dev container +#### Dev Container You can create, build, and push a package all from within our Dev Container. This means you do NOT need to be running Fedora/Ultramarine to create a package. From 34832c176fb94332966a36b1b740cbd977003333 Mon Sep 17 00:00:00 2001 From: Owen Zimmerman <123591347+Owen-sz@users.noreply.github.com> Date: Fri, 21 Nov 2025 01:51:17 -0600 Subject: [PATCH 03/16] buildong Co-authored-by: madomado --- pages/terra/contributing.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/terra/contributing.mdx b/pages/terra/contributing.mdx index 12b4ed03..68fe19e7 100644 --- a/pages/terra/contributing.mdx +++ b/pages/terra/contributing.mdx @@ -176,7 +176,7 @@ dependencies using `sudo dnf builddep path/to/pkgname.spec{: - You don't need to create `pkg`. It's not supposed to exist, just needs to be at the end of the build command - Modify the architecture to match your machine (`x86_64`, `i386`, `aarch64`) -- If needed (404 errors when buildong off `rawhide`, you can also modify the version it builds on (`43`, `43`, `el10`, etc.) +- If needed (404 errors when building off `rawhide`, you can also modify the version it builds on (`43`, `42`, `el10`, etc.) - If the package fails to build, fix your spec file accordingly - Usually the actual useful error message can be found before the Python traceback (from mock). - The built RPM(s) will be inside `anda-build/` From 64a07aa8010cf973c0f08261ce85af74cc3f712a Mon Sep 17 00:00:00 2001 From: Owen-sz Date: Sat, 22 Nov 2025 17:32:09 -0600 Subject: [PATCH 04/16] clarify some dev container stuff Signed-off-by: Owen-sz --- pages/terra/contributing.mdx | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/pages/terra/contributing.mdx b/pages/terra/contributing.mdx index 68fe19e7..f328a6a3 100644 --- a/pages/terra/contributing.mdx +++ b/pages/terra/contributing.mdx @@ -43,16 +43,13 @@ This means you do NOT need to be running Fedora/Ultramarine to create a package. You can run this devcontainer from Linux, macOS, or Windows. - Assuming you are using Visual Studio Code, Open Visual Studio Code and navigate to the Extensions menu located at the bottom of the left hand side bar. -- Install the [Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) extension. - +- Install [Docker](https://docs.docker.com/engine/install/). If on Linux, you will need to enable the service and restart your shell (reboot, logout, etc.). - Fork the [Terra sources repo](https://github.com/terrapkg/packages), and then `git clone` your fork. - Open this folder in Visual Studio Code (File -> Open Folder). -- It should prompt you to `reopen in Dev Container.` If not, press `Ctrl` + `Shift` + `P` and type `Open Folder in Container...` and select `Dev Container: Open Folder in Container...` and select your cloned Terra fork's folder. - -- You are now in the Terra Dev Container. -- You now have all the packages and configuration necessary to start building packages! +- It should prompt you to `reopen in Dev Container,` click this and wait for the Dev Container to open. If it doesn't prompt you, press `Ctrl` + `Shift` + `P`, type `Reopen in Container`, and press `Enter`. +- You are now in the Terra Dev Container, and have all the packages and configuration necessary to start building packages! -#### Language support +#### IDE/text editor language support The most common languages you will see: - RPMSPEC (`.spec`), for the package build scripts @@ -143,7 +140,7 @@ echo "this will also run when building pkg but for installing it into %{buildroo ``` - Add `Source0` or `Source1` or more. - These preambles should link to a compressed file (preferably `tar`) and will be extracted during `%prep` + These preambles should link to a compressed file (preferably a tarball) and will be extracted during `%prep`. You should've had the link prepared during [#Preparation](#preparation) :3 - Add a new line `%prep` - The source file will be automatically downloaded and @@ -184,7 +181,7 @@ dependencies using `sudo dnf builddep path/to/pkgname.spec{: ## Done? - Git commit and push; remember you must sign your commits! -- Create a pull request that merges to the `frawhide` branch +- Create a pull request that merges to the `frawhide` (effectivly the main) branch ## Automatic updates From 1ca10ffc21ce585e928ae1998878531c1428acac Mon Sep 17 00:00:00 2001 From: Owen Zimmerman <123591347+Owen-sz@users.noreply.github.com> Date: Sat, 22 Nov 2025 18:20:35 -0600 Subject: [PATCH 05/16] Update pages/terra/contributing.mdx Co-authored-by: Jaiden Riordan --- pages/terra/contributing.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/terra/contributing.mdx b/pages/terra/contributing.mdx index f328a6a3..b49e51d4 100644 --- a/pages/terra/contributing.mdx +++ b/pages/terra/contributing.mdx @@ -42,7 +42,7 @@ You can create, build, and push a package all from within our Dev Container. This means you do NOT need to be running Fedora/Ultramarine to create a package. You can run this devcontainer from Linux, macOS, or Windows. -- Assuming you are using Visual Studio Code, Open Visual Studio Code and navigate to the Extensions menu located at the bottom of the left hand side bar. +- If you're Visual Studio Code, open it and navigate to the Extensions menu located at the bottom of the left sidebar. - Install [Docker](https://docs.docker.com/engine/install/). If on Linux, you will need to enable the service and restart your shell (reboot, logout, etc.). - Fork the [Terra sources repo](https://github.com/terrapkg/packages), and then `git clone` your fork. - Open this folder in Visual Studio Code (File -> Open Folder). From 9353e5f5e1bdbd41746f27f03559f98bb58f7b67 Mon Sep 17 00:00:00 2001 From: Owen Zimmerman <123591347+Owen-sz@users.noreply.github.com> Date: Sat, 22 Nov 2025 18:20:46 -0600 Subject: [PATCH 06/16] Update pages/terra/contributing.mdx Co-authored-by: Jaiden Riordan --- pages/terra/contributing.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/terra/contributing.mdx b/pages/terra/contributing.mdx index b49e51d4..685778cf 100644 --- a/pages/terra/contributing.mdx +++ b/pages/terra/contributing.mdx @@ -43,7 +43,7 @@ This means you do NOT need to be running Fedora/Ultramarine to create a package. You can run this devcontainer from Linux, macOS, or Windows. - If you're Visual Studio Code, open it and navigate to the Extensions menu located at the bottom of the left sidebar. -- Install [Docker](https://docs.docker.com/engine/install/). If on Linux, you will need to enable the service and restart your shell (reboot, logout, etc.). +- Install [Docker](https://docs.docker.com/engine/install/). If you're on Linux, you'll need to enable the service and reboot. - Fork the [Terra sources repo](https://github.com/terrapkg/packages), and then `git clone` your fork. - Open this folder in Visual Studio Code (File -> Open Folder). - It should prompt you to `reopen in Dev Container,` click this and wait for the Dev Container to open. If it doesn't prompt you, press `Ctrl` + `Shift` + `P`, type `Reopen in Container`, and press `Enter`. From a761d52aac8a5f1c7d4e153fa13dea367bd381c9 Mon Sep 17 00:00:00 2001 From: Owen Zimmerman <123591347+Owen-sz@users.noreply.github.com> Date: Sat, 22 Nov 2025 18:20:57 -0600 Subject: [PATCH 07/16] Update pages/terra/contributing.mdx Co-authored-by: Jaiden Riordan --- pages/terra/contributing.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/terra/contributing.mdx b/pages/terra/contributing.mdx index 685778cf..6c9818b8 100644 --- a/pages/terra/contributing.mdx +++ b/pages/terra/contributing.mdx @@ -44,7 +44,7 @@ You can run this devcontainer from Linux, macOS, or Windows. - If you're Visual Studio Code, open it and navigate to the Extensions menu located at the bottom of the left sidebar. - Install [Docker](https://docs.docker.com/engine/install/). If you're on Linux, you'll need to enable the service and reboot. -- Fork the [Terra sources repo](https://github.com/terrapkg/packages), and then `git clone` your fork. +- Fork the [Terra sources repo](https://github.com/terrapkg/packages), and `git clone` your fork. - Open this folder in Visual Studio Code (File -> Open Folder). - It should prompt you to `reopen in Dev Container,` click this and wait for the Dev Container to open. If it doesn't prompt you, press `Ctrl` + `Shift` + `P`, type `Reopen in Container`, and press `Enter`. - You are now in the Terra Dev Container, and have all the packages and configuration necessary to start building packages! From b1d0ff657102753a672990ac0b55e1f4b001ad01 Mon Sep 17 00:00:00 2001 From: Owen Zimmerman <123591347+Owen-sz@users.noreply.github.com> Date: Sat, 22 Nov 2025 18:21:09 -0600 Subject: [PATCH 08/16] Update pages/terra/contributing.mdx Co-authored-by: Jaiden Riordan --- pages/terra/contributing.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/terra/contributing.mdx b/pages/terra/contributing.mdx index 6c9818b8..8e233446 100644 --- a/pages/terra/contributing.mdx +++ b/pages/terra/contributing.mdx @@ -49,7 +49,7 @@ You can run this devcontainer from Linux, macOS, or Windows. - It should prompt you to `reopen in Dev Container,` click this and wait for the Dev Container to open. If it doesn't prompt you, press `Ctrl` + `Shift` + `P`, type `Reopen in Container`, and press `Enter`. - You are now in the Terra Dev Container, and have all the packages and configuration necessary to start building packages! -#### IDE/text editor language support +#### Language Support in Editors The most common languages you will see: - RPMSPEC (`.spec`), for the package build scripts From 4e5a4667616281a76aae1a18fcfd871e18a0cfbc Mon Sep 17 00:00:00 2001 From: Owen Zimmerman <123591347+Owen-sz@users.noreply.github.com> Date: Sat, 22 Nov 2025 18:21:47 -0600 Subject: [PATCH 09/16] Update pages/terra/contributing.mdx Co-authored-by: Jaiden Riordan --- pages/terra/contributing.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/terra/contributing.mdx b/pages/terra/contributing.mdx index 8e233446..1ff9fb4b 100644 --- a/pages/terra/contributing.mdx +++ b/pages/terra/contributing.mdx @@ -90,7 +90,7 @@ If not/using a different IDE, we suggest installing language support for each of - You could use `rust2rpm` for **Rust** packages. - You could use `pyp2rpm` for **Python** packages. - You could use `go2rpm` for **Go** packages. - - else, find the source of the packages you are adding, preferably a URL to a `.tar.gz` archive + - Otherwise, find the source of the packages you are adding, preferably a URL to a `.tar.gz` archive - multiple archives are ok - non `.tar.gz` archives are also ok, but might require additional build dependencies - we also prefer archives from git repositories From b250eaad118ae7cc44110021eff8aadce2117a46 Mon Sep 17 00:00:00 2001 From: Owen Zimmerman <123591347+Owen-sz@users.noreply.github.com> Date: Sat, 22 Nov 2025 18:22:08 -0600 Subject: [PATCH 10/16] Update pages/terra/contributing.mdx Co-authored-by: Jaiden Riordan --- pages/terra/contributing.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/terra/contributing.mdx b/pages/terra/contributing.mdx index 1ff9fb4b..37b6e517 100644 --- a/pages/terra/contributing.mdx +++ b/pages/terra/contributing.mdx @@ -93,7 +93,7 @@ If not/using a different IDE, we suggest installing language support for each of - Otherwise, find the source of the packages you are adding, preferably a URL to a `.tar.gz` archive - multiple archives are ok - non `.tar.gz` archives are also ok, but might require additional build dependencies - - we also prefer archives from git repositories + - Archives from git repositories are preferred #### Editing the Spec file From 75ddbe1c458e619d37524acbb21fa0d0542f6b80 Mon Sep 17 00:00:00 2001 From: Owen Zimmerman <123591347+Owen-sz@users.noreply.github.com> Date: Sat, 22 Nov 2025 18:22:28 -0600 Subject: [PATCH 11/16] Update pages/terra/contributing.mdx Co-authored-by: Jaiden Riordan --- pages/terra/contributing.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/terra/contributing.mdx b/pages/terra/contributing.mdx index 37b6e517..9a10f66d 100644 --- a/pages/terra/contributing.mdx +++ b/pages/terra/contributing.mdx @@ -92,7 +92,7 @@ If not/using a different IDE, we suggest installing language support for each of - You could use `go2rpm` for **Go** packages. - Otherwise, find the source of the packages you are adding, preferably a URL to a `.tar.gz` archive - multiple archives are ok - - non `.tar.gz` archives are also ok, but might require additional build dependencies + - Non `.tar.gz` archives are also ok, but might require additional build dependencies - Archives from git repositories are preferred #### Editing the Spec file From ccaac617fadc5bf352ed4530943daa12cec49933 Mon Sep 17 00:00:00 2001 From: Owen Zimmerman <123591347+Owen-sz@users.noreply.github.com> Date: Sat, 22 Nov 2025 18:22:55 -0600 Subject: [PATCH 12/16] Update pages/terra/contributing.mdx Co-authored-by: Jaiden Riordan --- pages/terra/contributing.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/terra/contributing.mdx b/pages/terra/contributing.mdx index 9a10f66d..197f64af 100644 --- a/pages/terra/contributing.mdx +++ b/pages/terra/contributing.mdx @@ -91,7 +91,7 @@ If not/using a different IDE, we suggest installing language support for each of - You could use `pyp2rpm` for **Python** packages. - You could use `go2rpm` for **Go** packages. - Otherwise, find the source of the packages you are adding, preferably a URL to a `.tar.gz` archive - - multiple archives are ok + - Multiple archives are ok - Non `.tar.gz` archives are also ok, but might require additional build dependencies - Archives from git repositories are preferred From 3783072b3ee267ae52a35d99e4b253cf6466bbbd Mon Sep 17 00:00:00 2001 From: Owen Zimmerman <123591347+Owen-sz@users.noreply.github.com> Date: Sat, 22 Nov 2025 18:23:11 -0600 Subject: [PATCH 13/16] Update pages/terra/contributing.mdx Co-authored-by: Jaiden Riordan --- pages/terra/contributing.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/terra/contributing.mdx b/pages/terra/contributing.mdx index 197f64af..318b81a2 100644 --- a/pages/terra/contributing.mdx +++ b/pages/terra/contributing.mdx @@ -181,7 +181,7 @@ dependencies using `sudo dnf builddep path/to/pkgname.spec{: ## Done? - Git commit and push; remember you must sign your commits! -- Create a pull request that merges to the `frawhide` (effectivly the main) branch +- Create a pull request that merges to the `frawhide` branch, this is equivalent to main or master ## Automatic updates From fcb76b89ac1a6a2e267cd9379d29250e6ba4b90e Mon Sep 17 00:00:00 2001 From: Owen-sz Date: Sat, 22 Nov 2025 18:34:20 -0600 Subject: [PATCH 14/16] fix some stuff Signed-off-by: Owen-sz --- pages/terra/contributing.mdx | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/pages/terra/contributing.mdx b/pages/terra/contributing.mdx index 318b81a2..48ae21de 100644 --- a/pages/terra/contributing.mdx +++ b/pages/terra/contributing.mdx @@ -8,6 +8,7 @@ import { Callout } from "nextra/components"; # Contributing Thanks for contributing to Terra! + Terra is specifically designed to be as _package-maintainer-friendly_ as possible — you don't need to know everything about the infrastructure to create a package for Terra! See the following guide for creating a new package yourself. Quick and easy. @@ -34,7 +35,7 @@ Remember, it takes effort to create a package. If you ever need help, hop into - anda is also available via rust crates.io - If on an atomic system, this command works using podman: `podman run --rm --cap-add=SYS_ADMIN --privileged --volume ./:/anda --volume mock_cache:/var/lib/mock --workdir /anda ghcr.io/terrapkg/builder:frawhide anda` - Fork the [Terra sources repo](https://github.com/terrapkg/packages), and then `git clone` your fork. -- You are now ready for the Writing Sources section below. +- You are now ready for the [Writing Sources]([contributing#writing-sources](https://developer.fyralabs.com/terra/contributing#writing-sources)) section below. #### Dev Container @@ -72,7 +73,7 @@ If not/using a different IDE, we suggest installing language support for each of - The name of the folder name actually is just for identifications for Terra package maintainers. What matters is that the spec file name _must_ match with the package name defined in the spec file later. This is a Fedora `mock` limitation. - - For more information, check out our [packaging policies](policy). + - For more information, check out our [packaging policies]. 1. Edit `anda.hcl`, which tells [Andaman] how to build the package: ```hcl @@ -91,9 +92,9 @@ If not/using a different IDE, we suggest installing language support for each of - You could use `pyp2rpm` for **Python** packages. - You could use `go2rpm` for **Go** packages. - Otherwise, find the source of the packages you are adding, preferably a URL to a `.tar.gz` archive - - Multiple archives are ok - - Non `.tar.gz` archives are also ok, but might require additional build dependencies - - Archives from git repositories are preferred + - Multiple archives are ok. + - Archives not in `.tar.gz` format are also okay, but might require extra work. + - Archives from git repositories are preferred. #### Editing the Spec file From ee40bf5d5c43535cab6f27fb53f56ba6d0570ee9 Mon Sep 17 00:00:00 2001 From: Jaiden Riordan Date: Sat, 22 Nov 2025 19:42:32 -0600 Subject: [PATCH 15/16] Apply suggestion from @nothingneko --- pages/terra/contributing.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/terra/contributing.mdx b/pages/terra/contributing.mdx index 48ae21de..8e49cbb6 100644 --- a/pages/terra/contributing.mdx +++ b/pages/terra/contributing.mdx @@ -63,7 +63,7 @@ If not/using a different IDE, we suggest installing language support for each of ### Writing sources -1. Fork the [Terra sources repo](https://github.com/terrapkg/packages), and then `git clone` your fork. +1. Fork the [Terra sources repo](https://github.com/terrapkg/packages), and `git clone` your fork. 1. Create a folder named after the package name, for example: - A font named `lovelyfonttype` would go in `anda/fonts/lovelyfonttype`. - A Pantheon DE package would go in `anda/desktops/elementary/`. From acff14a1bfdc20f3b480d09653f0929c25ffa47b Mon Sep 17 00:00:00 2001 From: Owen-sz Date: Sat, 22 Nov 2025 19:45:59 -0600 Subject: [PATCH 16/16] change word Signed-off-by: Owen-sz --- pages/terra/contributing.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/pages/terra/contributing.mdx b/pages/terra/contributing.mdx index 8e49cbb6..f60cc848 100644 --- a/pages/terra/contributing.mdx +++ b/pages/terra/contributing.mdx @@ -88,9 +88,9 @@ If not/using a different IDE, we suggest installing language support for each of - It is a custom file format for RPM packages. - This [RPM Packaging Guide] might help newbies with no prior experiences with RPM specs. - This [Spec file format] docs goes into the details of the spec file format. - - You could use `rust2rpm` for **Rust** packages. - - You could use `pyp2rpm` for **Python** packages. - - You could use `go2rpm` for **Go** packages. + - You may use `rust2rpm` for **Rust** packages. + - You may use `pyp2rpm` for **Python** packages. + - You may use `go2rpm` for **Go** packages. - Otherwise, find the source of the packages you are adding, preferably a URL to a `.tar.gz` archive - Multiple archives are ok. - Archives not in `.tar.gz` format are also okay, but might require extra work.