GITBOOK-318: No subject

Author: Azathothas

SUMMARY.md

@@ -120,6 +120,7 @@
   * [Security](repositories/pkgcache/security.md)
 * [external](repositories/external/README.md)
   * [pkgforge-cargo](repositories/external/cargo-bins-1.md)
+  * [pkgforge-go](repositories/external/pkgforge-go.md)
   * [cargo-bins](repositories/external/cargo-bins.md)
   * [AM](repositories/external/am.md)
   * [appimage.github.io](repositories/external/appimage.github.io.md)

repositories/external/cargo-bins-1.md

@@ -1,6 +1,6 @@
 ---
 description: Officially maintained External Repo for All Crates
-icon: gear-complex-code
+icon: rust
 ---
 
 # pkgforge-cargo

repositories/external/pkgforge-go.md

@@ -0,0 +1,111 @@
+---
+description: Officially maintained External Repo for Go Packages
+icon: golang
+---
+
+# pkgforge-go
+
+{% hint style="info" %}
+* [x] Project: [https://github.com/pkgforge-go/builder](https://github.com/pkgforge-go/builder)
+* [x] Bugs/Issues: [https://github.com/pkgforge-go/builder/issues](https://github.com/pkgforge-go/builder/issues)
+* [x] Soar Repo: <mark style="color:orange;">**`pkgforge-go`**</mark>
+* [x] Cache: [<mark style="color:green;">**Yes**</mark>](#user-content-fn-1)[^1]
+* [x] Soar CI & Repo: [https://github.com/pkgforge-go/builder/tree/main/scripts](https://github.com/pkgforge-go/builder/tree/main/scripts)
+* [x] Metadata: [https://github.com/pkgforge-go/builder/tree/main/data](https://github.com/pkgforge-go/builder/tree/main/data)
+* [x] Type: Static
+{% endhint %}
+
+***
+
+### Trust
+
+{% hint style="success" %}
+This is as good as our own officially curated packages, as it is officially maintained by [@Azathothas](https://docs.pkgforge.dev/orgs/readme/people#azathothas). We have [clear workflow](https://github.com/pkgforge-go/builder/tree/main#-workflow) on what & how packages are built. And since the packages are built on [Github Actions](https://github.com/pkgforge-go/builder/actions/workflows/matrix_builds.yaml), transparent CI logs are also available for all of the packages.
+
+All of these make us say with high confidence that **you can trust it, as long as you trust that Github, Cargo, Crates.io or the package itself isn't compromised.**
+
+On a scale of <mark style="color:orange;">**1-10**</mark>, we had rate this source as <mark style="color:green;">**9**</mark>, **As this is an officially maintained external source**.
+{% endhint %}
+
+***
+
+### Add
+
+{% hint style="info" %}
+[Using <mark style="color:orange;">**`soar defconfig`**</mark>](#user-content-fn-2)[^2]  (<mark style="color:green;">**Recommended**</mark>)&#x20;
+
+{% code overflow="wrap" %}
+```bash
+#ONLY If you didn't already use it or have your own custom config
+soar defconfig --external
+soar sync
+soar list 'pkgforge-go'
+```
+{% endcode %}
+{% endhint %}
+
+{% hint style="info" %}
+[Using your text editor](#user-content-fn-3)[^3] \[ <mark style="color:orange;">**`~/.config/soar/config.toml`**</mark> ]
+
+* [x] Open it in a text editor
+
+{% code overflow="wrap" %}
+```bash
+#Open the config file using your favourtie editor
+#In this example, we will use micro
+mkdir -pv "~/.config/soar" &&\
+ micro "~/.config/soar/config.toml"
+```
+{% endcode %}
+
+* [x] Add the repo config (For other hosts, see [supported list](https://github.com/pkgforge-go/builder#-hosts).)
+
+{% code overflow="wrap" %}
+```toml
+[[repositories]]
+name = "pkgforge-go"
+url = "https://meta.pkgforge.dev/external/pkgforge-go/x86_64-Linux.json.zstd"
+```
+{% endcode %}
+
+* [x] Sync metadata
+
+{% code overflow="wrap" %}
+```bash
+soar sync
+soar list 'pkgforge-go'
+```
+{% endcode %}
+{% endhint %}
+
+{% hint style="info" %}
+[Using tee (<mark style="color:red;">**NOT-Recommended**</mark>)](#user-content-fn-4)[^4]
+
+* [x] Append (For other hosts, see [supported list](https://github.com/pkgforge-cargo/builder#-hosts).)
+
+{% code overflow="wrap" %}
+```bash
+mkdir -pv "~/.config/soar" &&\
+tee -a "~/.config/soar/config.toml" <<EOF
+[[repositories]]
+name = "pkgforge-go"
+url = "https://meta.pkgforge.dev/external/pkgforge-go/x86_64-Linux.json.zstd"
+EOF
+```
+{% endcode %}
+
+* [x] Sync metadata
+
+```bash
+soar sync
+soar list 'pkgforge-go'
+```
+{% endhint %}
+
+[^1]: Packages are stored on ghcr
+
+[^2]: Assuming you didn't run this before and you DO NOT have your own custom config at <mark style="color:orange;">**`~/.config/soar/config.toml`**</mark>
+
+[^3]: Should use if using custom config or the above command fails
+
+[^4]: Should only use if you can't use a text editor or want to do it non-interactively