Generic maintenance tasks

.github/CHANNELS.md

@@ -0,0 +1,13 @@
+# `main`
+
+The current tip-of-tree, absolute latest cutting edge build. Usually functional, though sometimes we accidentally break things.
+
+# `dev`
+
+The latest not fully-tested build.
+
+# `stable`
+
+When we believe we have a particularly useful build, we promote it to the stable channel.
+We intend to do this more or less every quarter, but this may vary. We may ship hotfixes 
+to the stable channel for high-priority bugs, although we intend to do this rarely.

.github/CODEOWNERS

@@ -1 +1,19 @@
-* @ss-o
+* @ss-o @z-shell
+
+# Order is important; the last matching pattern takes the most precedence.
+#*.sh    @z-shell
+#*.md    @z-shell
+
+# You can also use email addresses if you prefer. They'll be used to look up users just like we do for commit author emails.
+#*.sh z-shell@digitalclouds.dev
+
+# The `docs/*` pattern will match files like
+# `docs/getting-started.md` but not further nested files like
+# `docs/build-app/troubleshooting.md`.
+#docs/* @z-shell 
+
+# In this example, @z-shell owns any file in an `lib` directory anywhere in your repository.
+#lib/ @z-shell
+
+# In this example, @z-shell owns any file in the `.github` directory in the root of your repository.
+#/.github/ @z-shell

.github/label-commenter-config.yml

@@ -1,9 +1,7 @@
 comment:
   header: Hi, there.
-  footer: "\
-    ---\n\n\
-    > This is an automated comment. Responding to the bot or mentioning it won't have any effect.\n\n\"
-
+  footer: "\n\n > This is an automated comment. Responding to the bot or mentioning it won't have any effect.\n\n"
+
 labels:
   - name: invalid ⚠️
     labeled:

.github/labels.yml

@@ -30,11 +30,11 @@
   color: 5319e7
   description: "Work that improves the continuous integration."
 - name: "dependencies 📦"
-  color: fbcA04
+  color: fbca04
   description: "Change in project dependencies."
 
 - name: "in-progress ⚡"
-  color: fbca04
+  color: f510f4
   description: "Issue is currently being worked on by a developer."
 - name: "triage 📑"
   color: fbca04

.github/workflows/labeler.yml

@@ -1,7 +1,7 @@
 ---
 name: 🔖 Pull Request Labeler
 on:
-- pull_request_target
+  pull_request_target:
 
 permissions:
   contents: read
@@ -13,4 +13,5 @@ jobs:
     steps:
     - uses: actions/labeler@v3
       with:
-        repo-token: "${{ secrets.GH_PAT }}"
+        repo-token: "${{ secrets.GITHUB_TOKEN }}"
+        sync-labels: true

.github/workflows/lock.yml

@@ -4,7 +4,6 @@ name: 🔒 Lock closed issues and PRs
 on:
   schedule:
     - cron: "30 2 * * *"
-  workflow_dispatch:
 
 permissions:
   issues: write

.github/workflows/rebase.yml

@@ -9,7 +9,7 @@ jobs:
     if: github.event.issue.pull_request != '' && contains(github.event.comment.body, '/rebase')
     runs-on: ubuntu-latest
     steps:
-      - name: ☑️ Checkout the latest code
+      - name: ⤵️ Check out code from GitHub
         uses: actions/checkout@v2
         with:
           token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/zsh-check.yml

@@ -2,7 +2,6 @@
 name: ✅ Zsh Check
 
 on:
-  workflow_dispatch:
   pull_request_target:
 
 jobs:
@@ -11,7 +10,8 @@ jobs:
     outputs:
       matrix: ${{ steps.set-matrix.outputs.matrix }}
     steps:
-      - uses: actions/checkout@v2
+      - name: ⤵️ Check out code from GitHub
+        uses: actions/checkout@v2
       - name: "✨ Set matrix output"
         id: set-matrix
         run: |
@@ -26,7 +26,8 @@ jobs:
       matrix: ${{ fromJSON(needs.build-matrix.outputs.matrix) }}
 
     steps:
-      - uses: actions/checkout@v2
+      - name: ⤵️ Check out code from GitHub
+        uses: actions/checkout@v2
       - name: "✨ Install dependencies"
         run: |
           sudo apt install -y zsh

docs/CONTRIBUTING.md

@@ -6,26 +6,14 @@ Please note we have a [code of conduct](CODE_OF_CONDUCT.md), please follow it in
 ## Knowledge Base
 
 - [ZI Wiki](https://github.com/z-shell/zi/wiki)
-
-###  Zsh Official
-- [Zsh Site](http://zsh.sourceforge.net/)
-  - [Zsh FAQ](https://zsh.sourceforge.io/FAQ/)
-  - [Zsh Documentation](https://zsh.sourceforge.io/Doc/)
-  - [The Z Shell Manual](https://zsh.sourceforge.io/Doc/Release/index.html#Top) 
-### Useful
--   [Bash 2 Zsh](http://www.bash2zsh.com/)
--   [Zsh tips](http://www.zzapper.co.uk/zshtips.html)
--   [101 Powerful & Practical ZSH GLOBS](http://www.zzapper.co.uk/101ZshGlobs.php)
--   [Practical differences between Bash ans Zsh](https://apple.stackexchange.com/questions/361870/what-are-the-practical-differences-between-bash-and-zsh/361957#361957)
->
--   [zshdb - a gdb-like debugger for zsh](https://zshdb.readthedocs.io/en/latest/index.html)
--   [Debian Bug report logs: Bugs in package zsh](https://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=zsh)
+- [Zsh Plugin Standard](https://z-shell.github.io/docs/zsh/Zsh-Plugin-Standard.html)
+- [Zsh Native Scripting Handbook](https://z-shell.github.io/docs/zsh/Zsh-Native-Scripting-Handbook.html)
 
 ## Development environment setup
 
 **Notes:**
-  - Any files to support prefered editor should be collaborated and respected across repositories. e.g. [.editorconfig](https://gist.github.com/ss-o/1e8d9f3a710f78330a09ccc47ef6ddb2).
-  - [Doxygen For Shell Scripts](https://github.com/z-shell/zsdoc) - parses Zsh and Bash scripts. 
+> Any files to support prefered editor should be collaborated and respected across repositories. e.g. [.editorconfig](https://gist.github.com/ss-o/1e8d9f3a710f78330a09ccc47ef6ddb2).
+> [Doxygen For Shell Scripts](https://github.com/z-shell/zsdoc) - parses Zsh and Bash scripts.
 
 ### Clean Pull Request guidelines
 

docs/README.md

@@ -1,20 +1,19 @@
-<h1 align="center">
+<h2 align="center">
   <a href="https://github.com/z-shell/zi">
     <img src="images/logo.svg" alt="Logo" width="80" height="80">
   </a>
-❮ ZI ❯
-  </h1>
-<div align="center">
+❮ ZI ❯ 
+  </h2><div align="center">
+
+[![Project license](https://img.shields.io/github/license/z-shell/zi.svg?style=flat-square)](../LICENSE) [![Version][ver-badge]][ver-link] [![Pull Requests welcome](https://img.shields.io/badge/PRs-welcome-ff69b4.svg?style=flat-square)](https://github.com/z-shell/zi/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22)
+[![Tweet][twitter-badge]][twitter-link]
+
   <a href="https://github.com/z-shell/zi/issues/new?assignees=&labels=bug+%F0%9F%90%9E&template=01_bug_report.yml&title=bug%3A+">《 Report an issue 》</a>
   · <a href="https://github.com/z-shell/zi/issues/new?assignees=&labels=feature-request+%F0%9F%92%A1&template=02_feature_request.yml&title=feat%3A+">《 Request a Feature 》</a>
   · <a href="https://github.com/z-shell/zi/discussions">《 Ask a Question 》</a>
 </div>
 <div align="center">
 <br />
-
-[![Project license](https://img.shields.io/github/license/z-shell/zi.svg?style=flat-square)](../LICENSE) [![Version][ver-badge]][ver-link] [![Pull Requests welcome](https://img.shields.io/badge/PRs-welcome-ff69b4.svg?style=flat-square)](https://github.com/z-shell/zi/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22)
-[![Tweet][twitter-badge]][twitter-link]
-
 </div>
 
 <details open="open">
@@ -38,10 +37,8 @@
 
 </details>
 
----
-
 ## About
-
+  
 <h3><div align="center">
 
 **ZI is a fast and feature-rich plugin manager for [Zsh](https://zsh.sourceforge.io/) - [Unix shell](https://en.wikipedia.org/wiki/Unix_shell).** 
@@ -69,22 +66,20 @@
 - [ZI Wiki](https://github.com/z-shell/zi/wiki)
 - [Code Documentation](https://github.com/z-shell/zi/wiki/Code-Documentation)
 
+> **Tip:** [Advanced search](https://github.com/search/advanced?q=user%3Az-shell&type=Users)
+>
 > Curentlly we are working on how to improve and unify documentation in to one place.
 > If you know how we could improve it, please let us know. Any feedback, **greatly appreciated**.
 
 ## Getting Started
 
 ### Prerequisites
 
-> **[?]**
 > Work in progress.
 
 ### Installation
 
-> **[?]**
 > Interactive installation currently in development mode.
->
-> After installing and reloading the shell run: zi self-update
 
 #### ZI Loader
 
@@ -113,7 +108,7 @@ fi
 
 - This will:
   - Clone and install ZI if missing.
-  - If successful or not required will load ZI.
+  - If install successful or not required will load ZI.
   - Enable ZI completions.
 
 - All can be accomplished individually or skipped. The functionality will be attached in documentation subsequently.
@@ -122,8 +117,8 @@ fi
   - Visiting Wiki:
     - [Introduction](https://github.com/z-shell/zi/wiki/Introduction)
     - [ZI Annex meta plugins](https://github.com/z-shell/zi/wiki/z-a-meta-plugins)
-    - [Oh My Zsh integration](https://github.com/z-shell/zi/wiki/Example-Oh-My-Zsh-setup)
-    - [Gallery](https://github.com/z-shell/zi/wiki/GALLERY)
+    - [Oh My Zsh integration](https://github.com/z-shell/zi/wiki/Oh-My-Zsh-setup)
+    - [Gallery](https://github.com/z-shell/zi/wiki/Gallery)
 
 #### Interactive install (beta)
 
@@ -198,7 +193,7 @@ _For more information and to report security issues, please refer to our [securi
 ## Acknowledgements
 
 The [**Z-Shell**](https://github.com/z-shell) was created to recover the `zdharma` organization project which was deleted by the owner.
-We don't want to depend on an unreliable source. For this reason started maintaining all tools, everyone interested is welcome join.
+We don't want to depend on an unreliable source.
 [**ZI**](https://github.com/z-shell/zi), formerly known as zplugin, zinit, is an open source community project released under the [MIT License](../LICENSE).
 
 ### Authors & contributors