From 6a8105fd683594bfe2f132fa7d2ba88d2b0e5aed Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 20:48:02 -0400 Subject: [PATCH 01/17] Fix staging so it is in sync with main --- README.md | 23 +++++++++++++++++++---- 1 file changed, 19 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 3356492..9481dba 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,21 @@ -# about_docs +# about -This repo contains the markdown source that https://about.starcat.systems is generated from. +This repo contains the source Markdown and MkDocs files that generate [about.starcat.systems](https://about.starcat.systems) using [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/). -> [!important] -> **This repo is mirrored** between https://git.starcat.systems/starcatsys/about_docs and https://gitlab.com/starcatsys-mirror/starcatsys/about_docs. The version hosted on GitLab is a **read-only** version. Please use https://git.starcat.systems/starcatsys/about_docs for all interaction. \ No newline at end of file +[![Gitea Last Commit](https://img.shields.io/gitea/last-commit/starcatsys/about?display_timestamp=committer&gitea_url=https%3A%2F%2Fgit.starcat.systems&style=flat&logo=git&logoColor=fff&logoSize=auto)](https://git.starcat.systems/starcatsys/about_docs/) + +## Contributing + +We welcome your contributions and suggestions! Please see the [Meta](https://about.starcat.systems/handbook/meta/) section of our handbook for contribution and editing information. + +## Code Mirrors + +Source code is automatically pushed to the following mirrors. + +[![Static Badge](https://img.shields.io/badge/git.starcat.systems-main-green?style=flat&logo=forgejo&logoColor=fff&logoSize=auto)](https://git.starcat.systems/starcatsys/about/) + +[![Static Badge](https://img.shields.io/badge/sourcehut-mirror-blue?style=flat&logo=sourcehut&logoColor=fff&logoSize=auto)](https://git.sr.ht/~starcatsys/about) + +[![Static Badge](https://img.shields.io/badge/GitLab-mirror-blue?style=flat&logo=gitlab&logoColor=fff&logoSize=auto)](https://gitlab.com/starcatsys-mirror/starcatsys/about) + +📝 Note that all issues and pull requests should be directed to the [main forge](https://git.starcat.systems/starcatsys/about_docs). From 04422a6cac2adac2d1bb82519c8a2699251d34e6 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 20:49:48 -0400 Subject: [PATCH 02/17] fix "main forge" link in README --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9481dba..60a3ba3 100644 --- a/README.md +++ b/README.md @@ -18,4 +18,4 @@ Source code is automatically pushed to the following mirrors. [![Static Badge](https://img.shields.io/badge/GitLab-mirror-blue?style=flat&logo=gitlab&logoColor=fff&logoSize=auto)](https://gitlab.com/starcatsys-mirror/starcatsys/about) -📝 Note that all issues and pull requests should be directed to the [main forge](https://git.starcat.systems/starcatsys/about_docs). +📝 Note that all issues and pull requests should be directed to the [main forge](https://git.starcat.systems/starcatsys/about). From 6fea06e6ff86845ff2a41ce4b025239a9ccc1dc7 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 20:56:53 -0400 Subject: [PATCH 03/17] Update source git repo link across all pages --- docs/about/attribution.md | 2 +- docs/about/index.md | 2 +- docs/contact/index.md | 2 +- docs/docshq/index.md | 2 +- docs/handbook/index.md | 2 +- docs/handbook/infrastructure/communication/index.md | 2 +- docs/handbook/infrastructure/communication/mxroute.md | 2 +- docs/handbook/infrastructure/communication/voipms.md | 2 +- docs/handbook/infrastructure/index.md | 2 +- docs/handbook/infrastructure/monitoring/beszel.md | 2 +- docs/handbook/infrastructure/monitoring/index.md | 2 +- docs/handbook/infrastructure/monitoring/uptime.md | 2 +- docs/handbook/infrastructure/network/bunny.md | 2 +- docs/handbook/infrastructure/network/index.md | 2 +- .../infrastructure/servers_and_hosting/index.md | 2 +- .../infrastructure/servers_and_hosting/nfsn.md | 2 +- .../infrastructure/servers_and_hosting/pikapods.md | 2 +- docs/handbook/meta/editing.md | 10 +++++----- .../example_placeholder_page_admonition.md | 2 +- .../meta/example_pages/example_wip_admonition.md | 4 ++-- .../example_wip_placeholder_admonitions.md | 4 ++-- docs/handbook/meta/index.md | 2 +- docs/index.md | 2 +- docs/policies/index.md | 2 +- docs/postline/index.md | 2 +- docs/sourcecamp/index.md | 2 +- docs/stagelink/index.md | 2 +- docs/support/index.md | 2 +- 28 files changed, 34 insertions(+), 34 deletions(-) diff --git a/docs/about/attribution.md b/docs/about/attribution.md index 71046f4..a9e5a9c 100644 --- a/docs/about/attribution.md +++ b/docs/about/attribution.md @@ -4,7 +4,7 @@ This site, and all StarCat Systems projects, products, and services make use of ## Icons - [StarCat Systems](https://starcat.systems) logo - adapted from [Cat](https://thenounproject.com/icon/cat-6441095/) by [Md Ahasan Habib](https://thenounproject.com/creator/md_ahasan/) from Noun Project. - [`about` site](https://about.starcat.systems) favicon - adapted from [Book](https://thenounproject.com/icon/book-6252926/) by [iconpro86](https://thenounproject.com/creator/iconpro86/) from Noun Project. -- [`about-docs` repo](https://git.starcat.systems/starcatsys/about_docs) icon - adapted from [Book](https://thenounproject.com/icon/book-1833960/) by [Untashable](https://thenounproject.com/creator/untashable/) from Noun Project. +- [`about-docs` repo](https://git.starcat.systems/starcatsys/about) icon - adapted from [Book](https://thenounproject.com/icon/book-1833960/) by [Untashable](https://thenounproject.com/creator/untashable/) from Noun Project. - [`starcat-infra` org](https://git.starcat.systems/starcat-infra) icon - adapted from [Engineering](https://thenounproject.com/icon/engineering-7486606/) by [sunardi](https://thenounproject.com/creator/matah3574/) from Noun Project. - [`starcat-dev` org](https://git.starcat.systems/starcat-dev) icon - adapted from [lab](https://thenounproject.com/icon/lab-4581077/) by [cr9183353](https://thenounproject.com/creator/cr9183353/) from Noun Project. - [Git server](https://git.starcat.systems/) icon - adapted from [Arcticons Thin Line Icons Collection](https://www.svgrepo.com/collection/arcticons-thin-line-icons/) by [Donnnno](https://www.svgrepo.com/author/Donnnno/) and from the StarCat Systems logo, above. diff --git a/docs/about/index.md b/docs/about/index.md index b4a74b8..dc6d512 100644 --- a/docs/about/index.md +++ b/docs/about/index.md @@ -8,4 +8,4 @@ !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/contact/index.md b/docs/contact/index.md index 7f06ff9..e5833ba 100644 --- a/docs/contact/index.md +++ b/docs/contact/index.md @@ -8,4 +8,4 @@ !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/docshq/index.md b/docs/docshq/index.md index 8f20376..963f005 100644 --- a/docs/docshq/index.md +++ b/docs/docshq/index.md @@ -8,4 +8,4 @@ !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/handbook/index.md b/docs/handbook/index.md index acd649c..66b7158 100644 --- a/docs/handbook/index.md +++ b/docs/handbook/index.md @@ -8,4 +8,4 @@ !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/handbook/infrastructure/communication/index.md b/docs/handbook/infrastructure/communication/index.md index 7aa2598..a1e9080 100644 --- a/docs/handbook/infrastructure/communication/index.md +++ b/docs/handbook/infrastructure/communication/index.md @@ -8,4 +8,4 @@ !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/handbook/infrastructure/communication/mxroute.md b/docs/handbook/infrastructure/communication/mxroute.md index 38c4f1f..4c91572 100644 --- a/docs/handbook/infrastructure/communication/mxroute.md +++ b/docs/handbook/infrastructure/communication/mxroute.md @@ -29,4 +29,4 @@ Please see the [:material-book-lock: MXroute](https://internal-handbook.starcats !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/handbook/infrastructure/communication/voipms.md b/docs/handbook/infrastructure/communication/voipms.md index faa6493..737d674 100644 --- a/docs/handbook/infrastructure/communication/voipms.md +++ b/docs/handbook/infrastructure/communication/voipms.md @@ -20,4 +20,4 @@ If you need to set or change your voicemail message for your direct line voicema !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/handbook/infrastructure/index.md b/docs/handbook/infrastructure/index.md index 220e945..35261d1 100644 --- a/docs/handbook/infrastructure/index.md +++ b/docs/handbook/infrastructure/index.md @@ -10,4 +10,4 @@ Various things related to the servers, systems, and services that power all Star !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/handbook/infrastructure/monitoring/beszel.md b/docs/handbook/infrastructure/monitoring/beszel.md index 281b58f..8c5d03b 100644 --- a/docs/handbook/infrastructure/monitoring/beszel.md +++ b/docs/handbook/infrastructure/monitoring/beszel.md @@ -11,4 +11,4 @@ Simple, lightweight server monitoring !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/handbook/infrastructure/monitoring/index.md b/docs/handbook/infrastructure/monitoring/index.md index 0ef711b..89fc120 100644 --- a/docs/handbook/infrastructure/monitoring/index.md +++ b/docs/handbook/infrastructure/monitoring/index.md @@ -8,4 +8,4 @@ !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/handbook/infrastructure/monitoring/uptime.md b/docs/handbook/infrastructure/monitoring/uptime.md index b8310a0..0d74f97 100644 --- a/docs/handbook/infrastructure/monitoring/uptime.md +++ b/docs/handbook/infrastructure/monitoring/uptime.md @@ -13,4 +13,4 @@ Uptime Kuma is an easy-to-use self-hosted monitoring tool. !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/handbook/infrastructure/network/bunny.md b/docs/handbook/infrastructure/network/bunny.md index d0cfbfe..05f540f 100644 --- a/docs/handbook/infrastructure/network/bunny.md +++ b/docs/handbook/infrastructure/network/bunny.md @@ -8,4 +8,4 @@ !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/handbook/infrastructure/network/index.md b/docs/handbook/infrastructure/network/index.md index f0af8fe..3423b77 100644 --- a/docs/handbook/infrastructure/network/index.md +++ b/docs/handbook/infrastructure/network/index.md @@ -8,4 +8,4 @@ !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/handbook/infrastructure/servers_and_hosting/index.md b/docs/handbook/infrastructure/servers_and_hosting/index.md index 7885d3a..be11a48 100644 --- a/docs/handbook/infrastructure/servers_and_hosting/index.md +++ b/docs/handbook/infrastructure/servers_and_hosting/index.md @@ -8,4 +8,4 @@ !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/handbook/infrastructure/servers_and_hosting/nfsn.md b/docs/handbook/infrastructure/servers_and_hosting/nfsn.md index 3973479..44e9ae2 100644 --- a/docs/handbook/infrastructure/servers_and_hosting/nfsn.md +++ b/docs/handbook/infrastructure/servers_and_hosting/nfsn.md @@ -15,4 +15,4 @@ Please see the [:material-book-lock: NFSN](https://internal-handbook.starcatsys. !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/handbook/infrastructure/servers_and_hosting/pikapods.md b/docs/handbook/infrastructure/servers_and_hosting/pikapods.md index f4957f1..8f28e0d 100644 --- a/docs/handbook/infrastructure/servers_and_hosting/pikapods.md +++ b/docs/handbook/infrastructure/servers_and_hosting/pikapods.md @@ -15,4 +15,4 @@ When it makes sense, host any new pods in the `EU` region, as it places the pod !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/handbook/meta/editing.md b/docs/handbook/meta/editing.md index e7bce05..84a7f99 100644 --- a/docs/handbook/meta/editing.md +++ b/docs/handbook/meta/editing.md @@ -3,7 +3,7 @@ This page contains information on editing/making changes to this website. ## Material for MkDocs -This site is written in Markdown and is generated using [:simple-materialformkdocs: Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) Insiders. The source Markdown is stored in the [:simple-forgejo: about_docs Git repo](https://git.starcat.systems/starcatsys/about_docs). +This site is written in Markdown and is generated using [:simple-materialformkdocs: Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) Insiders. The source Markdown is stored in the [:simple-forgejo: about Git repo](https://git.starcat.systems/starcatsys/about). ## Icons Reference for all available Material for MkDocs icons: [:simple-materialformkdocs: Icons, Emojis](https://squidfunk.github.io/mkdocs-material/reference/icons-emojis/) @@ -33,7 +33,7 @@ Currently, the available configured colors are based off the built-in admonition :octicons-beaker-16:{ .example-purple } `:octicons-beaker-16:{ .example-purple }` :octicons-quote-16:{ .quote-grey } `:octicons-quote-16:{ .quote-grey }` -:octicons-flame-16:{ .tip-teal } Want to know how these colors work? Check out [:simple-forgejo: the CSS in the source](https://git.starcat.systems/starcatsys/about_docs/src/branch/main/docs/stylesheets/extra.css). +:octicons-flame-16:{ .tip-teal } Want to know how these colors work? Check out [:simple-forgejo: the CSS in the source](https://git.starcat.systems/starcatsys/about/src/branch/main/docs/stylesheets/extra.css). ## Admonitions Reference for using Admonitions: [:simple-materialformkdocs: Admonitions](https://squidfunk.github.io/mkdocs-material/reference/admonitions/#usage) @@ -102,7 +102,7 @@ Example page with this Work in Progress admonition: [:octicons-arrow-right-16: E !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. ``` @@ -122,11 +122,11 @@ Example page with the Placeholder Page admonition: [:octicons-arrow-right-16: Ex Typically, any page that is marked as a Placeholder Page should also be marked with the **Work in Progress** admonition because they are, by their nature, incomplete. Example page with the Placeholder and WIP admonitions: [:octicons-arrow-right-16: Example Placeholder and WIP Admonitions](example_pages/example_wip_placeholder_admonitions.md) - Source code that you can quickly copy from when making an index or placeholder page is located [:simple-forgejo: here](https://git.starcat.systems/starcatsys/about_docs/src/branch/main/docs/handbook/meta/example_pages/example_wip_placeholder_admonitions.md). + Source code that you can quickly copy from when making an index or placeholder page is located [:simple-forgejo: here](https://git.starcat.systems/starcatsys/about/src/branch/main/docs/handbook/meta/example_pages/example_wip_placeholder_admonitions.md). --- !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/handbook/meta/example_pages/example_placeholder_page_admonition.md b/docs/handbook/meta/example_pages/example_placeholder_page_admonition.md index 5e01f88..32060d7 100644 --- a/docs/handbook/meta/example_pages/example_placeholder_page_admonition.md +++ b/docs/handbook/meta/example_pages/example_placeholder_page_admonition.md @@ -5,7 +5,7 @@ There might be a little bit of content here, but nothing substantial. -This is an example page to show the [:octicons-arrow-right-16: Placeholder Page admonition](../editing.md#placeholder-page). You can see the source code for this page [:simple-forgejo: here](https://git.starcat.systems/starcatsys/about_docs/src/branch/main/docs/handbook/meta/example_pages/example_placeholder_page_admonition.md). +This is an example page to show the [:octicons-arrow-right-16: Placeholder Page admonition](../editing.md#placeholder-page). You can see the source code for this page [:simple-forgejo: here](https://git.starcat.systems/starcatsys/about/src/branch/main/docs/handbook/meta/example_pages/example_placeholder_page_admonition.md). --- Typically, you would also place a [:octicons-arrow-right-16: Work in Progress admonition](../editing.md#work-in-progress) on this page, as it is incomplete. For an example of a full Placeholder and WIP page, see [text](example_wip_placeholder_admonitions.md) \ No newline at end of file diff --git a/docs/handbook/meta/example_pages/example_wip_admonition.md b/docs/handbook/meta/example_pages/example_wip_admonition.md index 175b767..98cfdd4 100644 --- a/docs/handbook/meta/example_pages/example_wip_admonition.md +++ b/docs/handbook/meta/example_pages/example_wip_admonition.md @@ -1,5 +1,5 @@ # Example page: WIP admonition -This is an example page to show the [:octicons-arrow-right-16: Work in Progress admonition](../editing.md#work-in-progress) (scroll down to the bottom!). You can see the source code for this page [:simple-forgejo: here](https://git.starcat.systems/starcatsys/about_docs/src/branch/main/docs/handbook/meta/example_pages/example_wip_admonition.md). +This is an example page to show the [:octicons-arrow-right-16: Work in Progress admonition](../editing.md#work-in-progress) (scroll down to the bottom!). You can see the source code for this page [:simple-forgejo: here](https://git.starcat.systems/starcatsys/about/src/branch/main/docs/handbook/meta/example_pages/example_wip_admonition.md). Lorem ipsum dolor sit amet, consectetur adipiscing elit. Maecenas posuere, urna a tristique hendrerit, felis elit viverra diam, vel porta ante dui a nisi. Aenean mattis nibh est, vitae tristique enim pretium et. Maecenas quis purus egestas, rutrum dolor quis, ultricies neque. Vivamus sit amet lectus ligula. Etiam scelerisque leo odio, quis suscipit felis porttitor semper. Integer eu enim vehicula, molestie elit fringilla, porttitor quam. Ut consectetur feugiat tincidunt. @@ -10,4 +10,4 @@ Morbi tempus pretium nisi vel bibendum. Nam ut faucibus risus, molestie aliquet !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/handbook/meta/example_pages/example_wip_placeholder_admonitions.md b/docs/handbook/meta/example_pages/example_wip_placeholder_admonitions.md index 9551956..50c9ceb 100644 --- a/docs/handbook/meta/example_pages/example_wip_placeholder_admonitions.md +++ b/docs/handbook/meta/example_pages/example_wip_placeholder_admonitions.md @@ -3,10 +3,10 @@ !!! abstract "Placeholder Page" This is a placeholder page. Please see the site navigation for any sub-pages that exist. -This is an example page to show both the [:octicons-arrow-right-16: Placeholder Page admonition](../editing.md#placeholder-page) and the [:octicons-arrow-right-16: Work in Progress admonition](../editing.md#work-in-progress) (scroll down to the bottom!). You can see the source code for this page [:simple-forgejo: here](https://git.starcat.systems/starcatsys/about_docs/src/branch/main/docs/handbook/meta/example_pages/example_wip_placeholder_admonitions.md). +This is an example page to show both the [:octicons-arrow-right-16: Placeholder Page admonition](../editing.md#placeholder-page) and the [:octicons-arrow-right-16: Work in Progress admonition](../editing.md#work-in-progress) (scroll down to the bottom!). You can see the source code for this page [:simple-forgejo: here](https://git.starcat.systems/starcatsys/about/src/branch/main/docs/handbook/meta/example_pages/example_wip_placeholder_admonitions.md). --- !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/handbook/meta/index.md b/docs/handbook/meta/index.md index 38c8ff4..408ffb5 100644 --- a/docs/handbook/meta/index.md +++ b/docs/handbook/meta/index.md @@ -8,4 +8,4 @@ !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/index.md b/docs/index.md index 2adcd57..d23492b 100644 --- a/docs/index.md +++ b/docs/index.md @@ -82,7 +82,7 @@ You'll find the following sections of information on this site: ## :octicons-pencil-24: Edit this site -Found an error, or have a content suggestion? **You** are welcome to suggest changes to this site! The source material for this site is hosted on our [:simple-forgejo: Git server](https://git.starcat.systems/starcatsys/about_docs). Check out the [:octicons-arrow-right-16: Editing this site](editing.md) section in the Handbook for more information on making changes. +Found an error, or have a content suggestion? **You** are welcome to suggest changes to this site! The source material for this site is hosted on our [:simple-forgejo: Git server](https://git.starcat.systems/starcatsys/about). Check out the [:octicons-arrow-right-16: Editing this site](editing.md) section in the Handbook for more information on making changes. ## :fontawesome-brands-creative-commons: License The contents of this site are licensed under [:fontawesome-brands-creative-commons::fontawesome-brands-creative-commons-by::fontawesome-brands-creative-commons-sa: CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/), unless otherwise noted. \ No newline at end of file diff --git a/docs/policies/index.md b/docs/policies/index.md index 971f439..371ec25 100644 --- a/docs/policies/index.md +++ b/docs/policies/index.md @@ -8,4 +8,4 @@ !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/postline/index.md b/docs/postline/index.md index 60d613d..75e58f2 100644 --- a/docs/postline/index.md +++ b/docs/postline/index.md @@ -8,4 +8,4 @@ !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/sourcecamp/index.md b/docs/sourcecamp/index.md index 272f131..34027b5 100644 --- a/docs/sourcecamp/index.md +++ b/docs/sourcecamp/index.md @@ -8,4 +8,4 @@ !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/stagelink/index.md b/docs/stagelink/index.md index 884631b..5145831 100644 --- a/docs/stagelink/index.md +++ b/docs/stagelink/index.md @@ -8,4 +8,4 @@ !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file diff --git a/docs/support/index.md b/docs/support/index.md index e0386f4..dca9960 100644 --- a/docs/support/index.md +++ b/docs/support/index.md @@ -8,4 +8,4 @@ !!! example "Work in Progress" This page is not complete, and is subject to change. - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site. \ No newline at end of file + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file From 483940d2f314388c7722dd2dc795ded84a5db2d4 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 20:57:40 -0400 Subject: [PATCH 04/17] Fix git server URL --- docs/handbook/infrastructure/naming_conventions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/handbook/infrastructure/naming_conventions.md b/docs/handbook/infrastructure/naming_conventions.md index b80a594..576f430 100644 --- a/docs/handbook/infrastructure/naming_conventions.md +++ b/docs/handbook/infrastructure/naming_conventions.md @@ -13,4 +13,4 @@ env-category-(subservice)-(subdomain) - `subservice`: optional, used with `pubinfra` and `intinfra`. For shared infrastructure, what service(s) are being hosted. For example, `auth`, `accounts`, `portal`, etc. - `subdomain`: optional, used for specific products. Identifies the specific user's instance that is being hosted. -So, for the StarCat Systems [:simple-forgejo: Git server](https://git.starcat.systems/starcatsys/about_docs), the hostname is `prod-sourcecamp-starcatsys`. (`env`=`prod`, `category`=`sourcecamp`, `subservice`=empty, `subdomain`=`starcatsys`) \ No newline at end of file +So, for the StarCat Systems [:simple-forgejo: Git server](https://git.starcat.systems), the hostname is `prod-sourcecamp-starcatsys`. (`env`=`prod`, `category`=`sourcecamp`, `subservice`=empty, `subdomain`=`starcatsys`) \ No newline at end of file From 0b2536d90c3fc523ba106f738a9d8fc2198851aa Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 21:05:18 -0400 Subject: [PATCH 05/17] Rename DocsHub directory --- docs/.nav.yml | 2 +- docs/docshq/.nav.yml | 3 --- docs/docshub/.nav.yml | 3 +++ docs/{docshq => docshub}/index.md | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) delete mode 100644 docs/docshq/.nav.yml create mode 100644 docs/docshub/.nav.yml rename docs/{docshq => docshub}/index.md (90%) diff --git a/docs/.nav.yml b/docs/.nav.yml index 4b3ba3b..16685d4 100644 --- a/docs/.nav.yml +++ b/docs/.nav.yml @@ -1,7 +1,7 @@ nav: - about - sourcecamp - - docshq + - docshub - postline - stagelink - policies diff --git a/docs/docshq/.nav.yml b/docs/docshq/.nav.yml deleted file mode 100644 index 1a4a41f..0000000 --- a/docs/docshq/.nav.yml +++ /dev/null @@ -1,3 +0,0 @@ -title: DocsHQ -nav: - - index.md \ No newline at end of file diff --git a/docs/docshub/.nav.yml b/docs/docshub/.nav.yml new file mode 100644 index 0000000..160f8ec --- /dev/null +++ b/docs/docshub/.nav.yml @@ -0,0 +1,3 @@ +title: DocsHub +nav: + - index.md \ No newline at end of file diff --git a/docs/docshq/index.md b/docs/docshub/index.md similarity index 90% rename from docs/docshq/index.md rename to docs/docshub/index.md index 963f005..5d679a7 100644 --- a/docs/docshq/index.md +++ b/docs/docshub/index.md @@ -1,4 +1,4 @@ -# DocsHQ +# DocsHub !!! abstract "Placeholder Page" This is a placeholder page. Please see the site navigation for any sub-pages that exist. From fbd4f7930a40f05e083adadce577b3767ff3e6c5 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 21:05:32 -0400 Subject: [PATCH 06/17] Rename DocsHub on index and links --- docs/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/index.md b/docs/index.md index d23492b..4335238 100644 --- a/docs/index.md +++ b/docs/index.md @@ -39,13 +39,13 @@ You'll find the following sections of information on this site: [:octicons-arrow-right-16: SourceCamp](sourcecamp/index.md) -- :material-notebook-outline:{ .lg .middle } **DocsHQ** +- :material-notebook-outline:{ .lg .middle } **DocsHub** --- - Information about [DocsHQ](https://docshq.app), a continuous documentation platform. + Information about [DocsHub](https://docshub.io), a continuous documentation platform. - [:octicons-arrow-right-16: DocsHQ](docshq/index.md) + [:octicons-arrow-right-16: DocsHub](docshub/index.md) - :material-email-fast-outline:{ .lg .middle } **Postline** From dc2b4ed04abda5b744d195bb128eea0028f05fec Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 21:09:52 -0400 Subject: [PATCH 07/17] Update DocsHub domains --- docs/about/service_domains.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/about/service_domains.md b/docs/about/service_domains.md index f8a33f5..bdabfb7 100644 --- a/docs/about/service_domains.md +++ b/docs/about/service_domains.md @@ -19,7 +19,7 @@ This list helps to ensure that you're only dealing with official, legitimate Sta ## StarCat Services Domains List - `source.camp` - the homepage for SourceCamp -- `docshq.app` - the homepage for DocsHQ +- `docshub.io` - the homepage for DocsHub - `postline.email` - the homepage for Postline - `stagelink.cloud` - the homepage for StageLink @@ -32,8 +32,8 @@ This list helps to ensure that you're only dealing with official, legitimate Sta - `*.starcathosted.com` (e.g., `example.starcathosted.com`) - `*.hosted.source.camp` (e.g., `example.hosted.source.camp`) - :octicons-info-16:{ .info-blue } These subdomains host users' Forgejo instances. If you are an owner or user of one of these instances, you should use your Forgejo login information to sign in to Forgejo. Do not use your StarCat Accounts login information. -- `*.hosted.docshq.app` (e.g., `example.hosted.docshq.app`) - - :octicons-info-16:{ .info-blue } If your DocsHQ site is set to require authentication, you will be redirected to `auth.examplesite.hosted.docshq.app` to log in with your company credentials. Do not use your StarCat Accounts login information. +- `*.hosted.docshub.io` (e.g., `example.hosted.docshub.io`) + - :octicons-info-16:{ .info-blue } If your DocsHQ site is set to require authentication, you will be redirected to `auth.examplesite.hosted.docshub.io` to log in with your company credentials. Do not use your StarCat Accounts login information. - `lists.postline.email` - :octicons-info-16:{ .info-blue } When you create or subscribe to a Postline list, you will be prompted to create a separate Postline login which will only work with Postline lists. Do not use your StarCat Accounts login information. - `*.dedicated.postline.email` (e.g., `example.dedicated.postline.email`) From 44532072fb3d99fd1902c7073518e014e6962c12 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 21:37:20 -0400 Subject: [PATCH 08/17] Remove attribution for starcat-dev org icon --- docs/about/attribution.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/about/attribution.md b/docs/about/attribution.md index a9e5a9c..cdde5f6 100644 --- a/docs/about/attribution.md +++ b/docs/about/attribution.md @@ -6,7 +6,6 @@ This site, and all StarCat Systems projects, products, and services make use of - [`about` site](https://about.starcat.systems) favicon - adapted from [Book](https://thenounproject.com/icon/book-6252926/) by [iconpro86](https://thenounproject.com/creator/iconpro86/) from Noun Project. - [`about-docs` repo](https://git.starcat.systems/starcatsys/about) icon - adapted from [Book](https://thenounproject.com/icon/book-1833960/) by [Untashable](https://thenounproject.com/creator/untashable/) from Noun Project. - [`starcat-infra` org](https://git.starcat.systems/starcat-infra) icon - adapted from [Engineering](https://thenounproject.com/icon/engineering-7486606/) by [sunardi](https://thenounproject.com/creator/matah3574/) from Noun Project. -- [`starcat-dev` org](https://git.starcat.systems/starcat-dev) icon - adapted from [lab](https://thenounproject.com/icon/lab-4581077/) by [cr9183353](https://thenounproject.com/creator/cr9183353/) from Noun Project. - [Git server](https://git.starcat.systems/) icon - adapted from [Arcticons Thin Line Icons Collection](https://www.svgrepo.com/collection/arcticons-thin-line-icons/) by [Donnnno](https://www.svgrepo.com/author/Donnnno/) and from the StarCat Systems logo, above. - [SourceCamp](https://source.camp) logo - adapted from [camp](https://thenounproject.com/icon/camp-7375488/) by [Ricons](https://thenounproject.com/creator/ricons/) from Noun Project. - Icons used on this `about` site are by [Material Design](https://pictogrammers.com/library/mdi/), [FontAwesome](https://fontawesome.com/search?m=free), [Octicons](https://octicons.github.com/), and [Simple Icons](https://simpleicons.org/). \ No newline at end of file From 33f07a696a83a9e95b3c230bb507d941996dc5a4 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 21:38:30 -0400 Subject: [PATCH 09/17] Remove attribution for git server icon --- docs/about/attribution.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/about/attribution.md b/docs/about/attribution.md index cdde5f6..e9c03d3 100644 --- a/docs/about/attribution.md +++ b/docs/about/attribution.md @@ -6,6 +6,5 @@ This site, and all StarCat Systems projects, products, and services make use of - [`about` site](https://about.starcat.systems) favicon - adapted from [Book](https://thenounproject.com/icon/book-6252926/) by [iconpro86](https://thenounproject.com/creator/iconpro86/) from Noun Project. - [`about-docs` repo](https://git.starcat.systems/starcatsys/about) icon - adapted from [Book](https://thenounproject.com/icon/book-1833960/) by [Untashable](https://thenounproject.com/creator/untashable/) from Noun Project. - [`starcat-infra` org](https://git.starcat.systems/starcat-infra) icon - adapted from [Engineering](https://thenounproject.com/icon/engineering-7486606/) by [sunardi](https://thenounproject.com/creator/matah3574/) from Noun Project. -- [Git server](https://git.starcat.systems/) icon - adapted from [Arcticons Thin Line Icons Collection](https://www.svgrepo.com/collection/arcticons-thin-line-icons/) by [Donnnno](https://www.svgrepo.com/author/Donnnno/) and from the StarCat Systems logo, above. - [SourceCamp](https://source.camp) logo - adapted from [camp](https://thenounproject.com/icon/camp-7375488/) by [Ricons](https://thenounproject.com/creator/ricons/) from Noun Project. - Icons used on this `about` site are by [Material Design](https://pictogrammers.com/library/mdi/), [FontAwesome](https://fontawesome.com/search?m=free), [Octicons](https://octicons.github.com/), and [Simple Icons](https://simpleicons.org/). \ No newline at end of file From 87f4612e24eefd8dbd0f8f0e4d665f5356c58e48 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 21:46:28 -0400 Subject: [PATCH 10/17] Add StageLink logo attribution --- docs/about/attribution.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/about/attribution.md b/docs/about/attribution.md index e9c03d3..582e3ef 100644 --- a/docs/about/attribution.md +++ b/docs/about/attribution.md @@ -7,4 +7,5 @@ This site, and all StarCat Systems projects, products, and services make use of - [`about-docs` repo](https://git.starcat.systems/starcatsys/about) icon - adapted from [Book](https://thenounproject.com/icon/book-1833960/) by [Untashable](https://thenounproject.com/creator/untashable/) from Noun Project. - [`starcat-infra` org](https://git.starcat.systems/starcat-infra) icon - adapted from [Engineering](https://thenounproject.com/icon/engineering-7486606/) by [sunardi](https://thenounproject.com/creator/matah3574/) from Noun Project. - [SourceCamp](https://source.camp) logo - adapted from [camp](https://thenounproject.com/icon/camp-7375488/) by [Ricons](https://thenounproject.com/creator/ricons/) from Noun Project. +- [StageLink](https://stagelink.cloud) logo - adapted from [slider](https://thenounproject.com/icon/slider-2309209/) by [DinosoftLabs](https://thenounproject.com/creator/dinosoftlab/) from Noun Project. - Icons used on this `about` site are by [Material Design](https://pictogrammers.com/library/mdi/), [FontAwesome](https://fontawesome.com/search?m=free), [Octicons](https://octicons.github.com/), and [Simple Icons](https://simpleicons.org/). \ No newline at end of file From 41d8aba8ea58cfea43d55e544468421896518198 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 21:48:58 -0400 Subject: [PATCH 11/17] Update 'about' repo name in attribution --- docs/about/attribution.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/about/attribution.md b/docs/about/attribution.md index 582e3ef..8682034 100644 --- a/docs/about/attribution.md +++ b/docs/about/attribution.md @@ -4,7 +4,7 @@ This site, and all StarCat Systems projects, products, and services make use of ## Icons - [StarCat Systems](https://starcat.systems) logo - adapted from [Cat](https://thenounproject.com/icon/cat-6441095/) by [Md Ahasan Habib](https://thenounproject.com/creator/md_ahasan/) from Noun Project. - [`about` site](https://about.starcat.systems) favicon - adapted from [Book](https://thenounproject.com/icon/book-6252926/) by [iconpro86](https://thenounproject.com/creator/iconpro86/) from Noun Project. -- [`about-docs` repo](https://git.starcat.systems/starcatsys/about) icon - adapted from [Book](https://thenounproject.com/icon/book-1833960/) by [Untashable](https://thenounproject.com/creator/untashable/) from Noun Project. +- [`about` repo](https://git.starcat.systems/starcatsys/about) icon - adapted from [Book](https://thenounproject.com/icon/book-1833960/) by [Untashable](https://thenounproject.com/creator/untashable/) from Noun Project. - [`starcat-infra` org](https://git.starcat.systems/starcat-infra) icon - adapted from [Engineering](https://thenounproject.com/icon/engineering-7486606/) by [sunardi](https://thenounproject.com/creator/matah3574/) from Noun Project. - [SourceCamp](https://source.camp) logo - adapted from [camp](https://thenounproject.com/icon/camp-7375488/) by [Ricons](https://thenounproject.com/creator/ricons/) from Noun Project. - [StageLink](https://stagelink.cloud) logo - adapted from [slider](https://thenounproject.com/icon/slider-2309209/) by [DinosoftLabs](https://thenounproject.com/creator/dinosoftlab/) from Noun Project. From eda93c36e01aa6334f2ba76d39a76503a3430d33 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 21:51:25 -0400 Subject: [PATCH 12/17] Add DocsHub logo attribution --- docs/about/attribution.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/about/attribution.md b/docs/about/attribution.md index 8682034..4a42467 100644 --- a/docs/about/attribution.md +++ b/docs/about/attribution.md @@ -7,5 +7,6 @@ This site, and all StarCat Systems projects, products, and services make use of - [`about` repo](https://git.starcat.systems/starcatsys/about) icon - adapted from [Book](https://thenounproject.com/icon/book-1833960/) by [Untashable](https://thenounproject.com/creator/untashable/) from Noun Project. - [`starcat-infra` org](https://git.starcat.systems/starcat-infra) icon - adapted from [Engineering](https://thenounproject.com/icon/engineering-7486606/) by [sunardi](https://thenounproject.com/creator/matah3574/) from Noun Project. - [SourceCamp](https://source.camp) logo - adapted from [camp](https://thenounproject.com/icon/camp-7375488/) by [Ricons](https://thenounproject.com/creator/ricons/) from Noun Project. +- [DocsHub](https://docshub.io) logo - adapted from [Document](https://thenounproject.com/icon/document-6244658/) by [Reion](https://thenounproject.com/creator/dickydante/) from Noun Project. - [StageLink](https://stagelink.cloud) logo - adapted from [slider](https://thenounproject.com/icon/slider-2309209/) by [DinosoftLabs](https://thenounproject.com/creator/dinosoftlab/) from Noun Project. - Icons used on this `about` site are by [Material Design](https://pictogrammers.com/library/mdi/), [FontAwesome](https://fontawesome.com/search?m=free), [Octicons](https://octicons.github.com/), and [Simple Icons](https://simpleicons.org/). \ No newline at end of file From ca54fd4f3c83df9bc5d082f0f134f67fba864fa6 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 21:51:59 -0400 Subject: [PATCH 13/17] Update attribution icon order --- docs/about/attribution.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/about/attribution.md b/docs/about/attribution.md index 4a42467..3365e47 100644 --- a/docs/about/attribution.md +++ b/docs/about/attribution.md @@ -6,7 +6,7 @@ This site, and all StarCat Systems projects, products, and services make use of - [`about` site](https://about.starcat.systems) favicon - adapted from [Book](https://thenounproject.com/icon/book-6252926/) by [iconpro86](https://thenounproject.com/creator/iconpro86/) from Noun Project. - [`about` repo](https://git.starcat.systems/starcatsys/about) icon - adapted from [Book](https://thenounproject.com/icon/book-1833960/) by [Untashable](https://thenounproject.com/creator/untashable/) from Noun Project. - [`starcat-infra` org](https://git.starcat.systems/starcat-infra) icon - adapted from [Engineering](https://thenounproject.com/icon/engineering-7486606/) by [sunardi](https://thenounproject.com/creator/matah3574/) from Noun Project. +- Icons used on this `about` site are by [Material Design](https://pictogrammers.com/library/mdi/), [FontAwesome](https://fontawesome.com/search?m=free), [Octicons](https://octicons.github.com/), and [Simple Icons](https://simpleicons.org/). - [SourceCamp](https://source.camp) logo - adapted from [camp](https://thenounproject.com/icon/camp-7375488/) by [Ricons](https://thenounproject.com/creator/ricons/) from Noun Project. - [DocsHub](https://docshub.io) logo - adapted from [Document](https://thenounproject.com/icon/document-6244658/) by [Reion](https://thenounproject.com/creator/dickydante/) from Noun Project. -- [StageLink](https://stagelink.cloud) logo - adapted from [slider](https://thenounproject.com/icon/slider-2309209/) by [DinosoftLabs](https://thenounproject.com/creator/dinosoftlab/) from Noun Project. -- Icons used on this `about` site are by [Material Design](https://pictogrammers.com/library/mdi/), [FontAwesome](https://fontawesome.com/search?m=free), [Octicons](https://octicons.github.com/), and [Simple Icons](https://simpleicons.org/). \ No newline at end of file +- [StageLink](https://stagelink.cloud) logo - adapted from [slider](https://thenounproject.com/icon/slider-2309209/) by [DinosoftLabs](https://thenounproject.com/creator/dinosoftlab/) from Noun Project. \ No newline at end of file From f0299921ff8c1b428bd9797949af382e7a2a79a3 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 21:56:17 -0400 Subject: [PATCH 14/17] Make separate syntax page --- docs/handbook/meta/.nav.yml | 3 +- docs/handbook/meta/editing.md | 117 ------------------------------- docs/handbook/meta/syntax.md | 127 ++++++++++++++++++++++++++++++++++ 3 files changed, 129 insertions(+), 118 deletions(-) create mode 100644 docs/handbook/meta/syntax.md diff --git a/docs/handbook/meta/.nav.yml b/docs/handbook/meta/.nav.yml index 3fbd06f..9d27d6d 100644 --- a/docs/handbook/meta/.nav.yml +++ b/docs/handbook/meta/.nav.yml @@ -1,4 +1,5 @@ title: Meta nav: - index.md - - editing.md \ No newline at end of file + - editing.md + - syntax.md \ No newline at end of file diff --git a/docs/handbook/meta/editing.md b/docs/handbook/meta/editing.md index 84a7f99..7009b8a 100644 --- a/docs/handbook/meta/editing.md +++ b/docs/handbook/meta/editing.md @@ -5,124 +5,7 @@ This page contains information on editing/making changes to this website. ## Material for MkDocs This site is written in Markdown and is generated using [:simple-materialformkdocs: Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) Insiders. The source Markdown is stored in the [:simple-forgejo: about Git repo](https://git.starcat.systems/starcatsys/about). -## Icons -Reference for all available Material for MkDocs icons: [:simple-materialformkdocs: Icons, Emojis](https://squidfunk.github.io/mkdocs-material/reference/icons-emojis/) -### Commonly-used icons for links -:octicons-arrow-right-16: `:octicons-arrow-right-16:` - used for links within the wiki -:octicons-tab-external-16: `:octicons-tab-external-16:` - used for links outside the wiki, but within StarCat Systems -:octicons-link-external-16: `:octicons-link-external-16:` - used for external links to sites not controlled by StarCat Systems -:material-book-lock: `:material-book-lock:` - used for links to the StarCat Systems internal handbook - -### Coloring icons -You can add a color to an icon by adding the CSS color after the icon, like this: -:fontawesome-solid-dragon:{ .bug-pink } `:fontawesome-solid-dragon:{ .bug-pink }` - - -Currently, the available configured colors are based off the built-in admonition colors and icons, as follows: - -:fontawesome-regular-note-sticky:{ .note-blue } `:fontawesome-regular-note-sticky:{ .note-blue }` -:octicons-info-16:{ .info-blue } `:octicons-info-16:{ .info-blue }` -:octicons-flame-16:{ .tip-teal } `:octicons-flame-16:{ .tip-teal }` -:octicons-check-16:{ .success-green } `:octicons-check-16:{ .success-green }` -:octicons-question-16:{ .question-green } `:octicons-question-16:{ .question-green }` -:octicons-alert-16:{ .warning-yellow } `:octicons-alert-16:{ .warning-yellow }` -:octicons-x-circle-16:{ .failure-red } `:octicons-x-circle-16:{ .failure-red }` -:octicons-zap-16:{ .danger-red } `:octicons-zap-16:{ .danger-red }` -:octicons-bug-16:{ .bug-pink } `:octicons-bug-16:{ .bug-pink }` -:octicons-beaker-16:{ .example-purple } `:octicons-beaker-16:{ .example-purple }` -:octicons-quote-16:{ .quote-grey } `:octicons-quote-16:{ .quote-grey }` - -:octicons-flame-16:{ .tip-teal } Want to know how these colors work? Check out [:simple-forgejo: the CSS in the source](https://git.starcat.systems/starcatsys/about/src/branch/main/docs/stylesheets/extra.css). - -## Admonitions -Reference for using Admonitions: [:simple-materialformkdocs: Admonitions](https://squidfunk.github.io/mkdocs-material/reference/admonitions/#usage) - - - -### Common Admonition Usage -Here are some common admonitions, when you might use them, and quick code snippets that you can paste in. - -!!! note - Highlights information that users should take into account, even when skimming. - - - ``` - !!! note - Highlights information that users should take into account, even when skimming. - ``` - -!!! tip - Helpful advice for doing things better or more easily. - - ``` - !!! tip - Helpful advice for doing things better or more easily. - ``` - -!!! warning - Advises about risks or negative outcomes of certain actions. - - ``` - !!! warning - Advises about risks or negative outcomes of certain actions. - ``` - -!!! danger - Urgent info that needs immediate user attention to avoid problems. - - ``` - !!! danger - Urgent info that needs immediate user attention to avoid problems. - ``` - -!!! bug - Information about a known bug in a current version. Whenever possible, provide a link to the issue report. Place a link back to the page with this admonition, in the issue report so that the admonition can be removed when the bug is closed. - - ``` - !!! bug - Information about a known bug in a current version. Whenever possible, provide a link to the issue report. Place a link back to the page with this admonition, in the issue report so that the admonition can be removed when the bug is closed. - ``` - -### Custom -We've modified a couple of the standard admonitions to mean something a little different on this site. - -#### Work in Progress -For pages that aren't yet complete, and need revisions (that we know are going to be revised sooner/more frequently than a typical page.) - -Typically, we will put this at the bottom of the page content, with a dividing line between any page content and this admonition. - -Example page with this Work in Progress admonition: [:octicons-arrow-right-16: Example WIP Admonition](example_pages/example_wip_admonition.md) - -??? quote "Syntax" - Copy and paste at the bottom of page content: - ``` - --- - - !!! example "Work in Progress" - This page is not complete, and is subject to change. - - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. - ``` - - -#### Placeholder Page -For pages that are newly created and have no (or very little) content on the page itself. Also used for `index.md` pages in directories that have other contents, but no content on the directory index. - -Example page with the Placeholder Page admonition: [:octicons-arrow-right-16: Example Placeholder Page Admonition](example_pages/example_placeholder_page_admonition.md) - -??? quote "Syntax" - Copy and paste at the bottom of page content: - ``` - !!! abstract "Placeholder Page" - This is a placeholder page. Please see the site navigation for any sub-pages that exist. - ``` - -!!! tip - Typically, any page that is marked as a Placeholder Page should also be marked with the **Work in Progress** admonition because they are, by their nature, incomplete. - - Example page with the Placeholder and WIP admonitions: [:octicons-arrow-right-16: Example Placeholder and WIP Admonitions](example_pages/example_wip_placeholder_admonitions.md) - Source code that you can quickly copy from when making an index or placeholder page is located [:simple-forgejo: here](https://git.starcat.systems/starcatsys/about/src/branch/main/docs/handbook/meta/example_pages/example_wip_placeholder_admonitions.md). --- diff --git a/docs/handbook/meta/syntax.md b/docs/handbook/meta/syntax.md new file mode 100644 index 0000000..09d3b47 --- /dev/null +++ b/docs/handbook/meta/syntax.md @@ -0,0 +1,127 @@ +# Syntax + +## Icons +Reference for all available Material for MkDocs icons: [:simple-materialformkdocs: Icons, Emojis](https://squidfunk.github.io/mkdocs-material/reference/icons-emojis/) + +### Commonly-used icons for links +:octicons-arrow-right-16: `:octicons-arrow-right-16:` - used for links within the wiki +:octicons-tab-external-16: `:octicons-tab-external-16:` - used for links outside the wiki, but within StarCat Systems +:octicons-link-external-16: `:octicons-link-external-16:` - used for external links to sites not controlled by StarCat Systems +:material-book-lock: `:material-book-lock:` - used for links to the StarCat Systems internal handbook + +### Coloring icons +You can add a color to an icon by adding the CSS color after the icon, like this: +:fontawesome-solid-dragon:{ .bug-pink } `:fontawesome-solid-dragon:{ .bug-pink }` + + +Currently, the available configured colors are based off the built-in admonition colors and icons, as follows: + +:fontawesome-regular-note-sticky:{ .note-blue } `:fontawesome-regular-note-sticky:{ .note-blue }` +:octicons-info-16:{ .info-blue } `:octicons-info-16:{ .info-blue }` +:octicons-flame-16:{ .tip-teal } `:octicons-flame-16:{ .tip-teal }` +:octicons-check-16:{ .success-green } `:octicons-check-16:{ .success-green }` +:octicons-question-16:{ .question-green } `:octicons-question-16:{ .question-green }` +:octicons-alert-16:{ .warning-yellow } `:octicons-alert-16:{ .warning-yellow }` +:octicons-x-circle-16:{ .failure-red } `:octicons-x-circle-16:{ .failure-red }` +:octicons-zap-16:{ .danger-red } `:octicons-zap-16:{ .danger-red }` +:octicons-bug-16:{ .bug-pink } `:octicons-bug-16:{ .bug-pink }` +:octicons-beaker-16:{ .example-purple } `:octicons-beaker-16:{ .example-purple }` +:octicons-quote-16:{ .quote-grey } `:octicons-quote-16:{ .quote-grey }` + +:octicons-flame-16:{ .tip-teal } Want to know how these colors work? Check out [:simple-forgejo: the CSS in the source](https://git.starcat.systems/starcatsys/about/src/branch/main/docs/stylesheets/extra.css). + +## Admonitions +Reference for using Admonitions: [:simple-materialformkdocs: Admonitions](https://squidfunk.github.io/mkdocs-material/reference/admonitions/#usage) + + + +### Common Admonition Usage +Here are some common admonitions, when you might use them, and quick code snippets that you can paste in. + +!!! note + Highlights information that users should take into account, even when skimming. + + + ``` + !!! note + Highlights information that users should take into account, even when skimming. + ``` + +!!! tip + Helpful advice for doing things better or more easily. + + ``` + !!! tip + Helpful advice for doing things better or more easily. + ``` + +!!! warning + Advises about risks or negative outcomes of certain actions. + + ``` + !!! warning + Advises about risks or negative outcomes of certain actions. + ``` + +!!! danger + Urgent info that needs immediate user attention to avoid problems. + + ``` + !!! danger + Urgent info that needs immediate user attention to avoid problems. + ``` + +!!! bug + Information about a known bug in a current version. Whenever possible, provide a link to the issue report. Place a link back to the page with this admonition, in the issue report so that the admonition can be removed when the bug is closed. + + ``` + !!! bug + Information about a known bug in a current version. Whenever possible, provide a link to the issue report. Place a link back to the page with this admonition, in the issue report so that the admonition can be removed when the bug is closed. + ``` + +### Custom +We've modified a couple of the standard admonitions to mean something a little different on this site. + +#### Work in Progress +For pages that aren't yet complete, and need revisions (that we know are going to be revised sooner/more frequently than a typical page.) + +Typically, we will put this at the bottom of the page content, with a dividing line between any page content and this admonition. + +Example page with this Work in Progress admonition: [:octicons-arrow-right-16: Example WIP Admonition](example_pages/example_wip_admonition.md) + +??? quote "Syntax" + Copy and paste at the bottom of page content: + ``` + --- + + !!! example "Work in Progress" + This page is not complete, and is subject to change. + + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. + ``` + + +#### Placeholder Page +For pages that are newly created and have no (or very little) content on the page itself. Also used for `index.md` pages in directories that have other contents, but no content on the directory index. + +Example page with the Placeholder Page admonition: [:octicons-arrow-right-16: Example Placeholder Page Admonition](example_pages/example_placeholder_page_admonition.md) + +??? quote "Syntax" + Copy and paste at the bottom of page content: + ``` + !!! abstract "Placeholder Page" + This is a placeholder page. Please see the site navigation for any sub-pages that exist. + ``` + +!!! tip + Typically, any page that is marked as a Placeholder Page should also be marked with the **Work in Progress** admonition because they are, by their nature, incomplete. + + Example page with the Placeholder and WIP admonitions: [:octicons-arrow-right-16: Example Placeholder and WIP Admonitions](example_pages/example_wip_placeholder_admonitions.md) + Source code that you can quickly copy from when making an index or placeholder page is located [:simple-forgejo: here](https://git.starcat.systems/starcatsys/about/src/branch/main/docs/handbook/meta/example_pages/example_wip_placeholder_admonitions.md). + +--- + +!!! example "Work in Progress" + This page is not complete, and is subject to change. + + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file From 1ac79049b187ec0d5fb56e06f5a7f13546e7d7e7 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 22:03:20 -0400 Subject: [PATCH 15/17] Add syntax reference to editing and syntax docs - Introduced a new section on syntax in editing.md - Added a detailed syntax reference in syntax.md --- docs/handbook/meta/editing.md | 3 ++- docs/handbook/meta/syntax.md | 2 ++ 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/handbook/meta/editing.md b/docs/handbook/meta/editing.md index 7009b8a..2394f73 100644 --- a/docs/handbook/meta/editing.md +++ b/docs/handbook/meta/editing.md @@ -5,7 +5,8 @@ This page contains information on editing/making changes to this website. ## Material for MkDocs This site is written in Markdown and is generated using [:simple-materialformkdocs: Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) Insiders. The source Markdown is stored in the [:simple-forgejo: about Git repo](https://git.starcat.systems/starcatsys/about). - +## Syntax +Please see [:octicons-arrow-right-16: Syntax](syntax.md) for reference on various Material for MkDocs syntax you can use in your Markdown, and specific usage on this site. --- diff --git a/docs/handbook/meta/syntax.md b/docs/handbook/meta/syntax.md index 09d3b47..794f544 100644 --- a/docs/handbook/meta/syntax.md +++ b/docs/handbook/meta/syntax.md @@ -1,5 +1,7 @@ # Syntax +You can find a reference for the syntax used in writing this site in the Material for MkDocs [:simple-materialformkdocs: Reference section](https://squidfunk.github.io/mkdocs-material/reference/). On this particular site, there are some specific syntax point that we use. This page is intended to provide a reference for those specifics. + ## Icons Reference for all available Material for MkDocs icons: [:simple-materialformkdocs: Icons, Emojis](https://squidfunk.github.io/mkdocs-material/reference/icons-emojis/) From 42b143ec87d5a0827fa01f0c0940e73e721095d9 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 22:07:08 -0400 Subject: [PATCH 16/17] Update handbook meta structure and content --- docs/handbook/meta/editing.md | 3 --- docs/handbook/meta/index.md | 9 +++++++-- 2 files changed, 7 insertions(+), 5 deletions(-) diff --git a/docs/handbook/meta/editing.md b/docs/handbook/meta/editing.md index 2394f73..810a45b 100644 --- a/docs/handbook/meta/editing.md +++ b/docs/handbook/meta/editing.md @@ -2,9 +2,6 @@ This page contains information on editing/making changes to this website. -## Material for MkDocs -This site is written in Markdown and is generated using [:simple-materialformkdocs: Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) Insiders. The source Markdown is stored in the [:simple-forgejo: about Git repo](https://git.starcat.systems/starcatsys/about). - ## Syntax Please see [:octicons-arrow-right-16: Syntax](syntax.md) for reference on various Material for MkDocs syntax you can use in your Markdown, and specific usage on this site. diff --git a/docs/handbook/meta/index.md b/docs/handbook/meta/index.md index 408ffb5..7441ac7 100644 --- a/docs/handbook/meta/index.md +++ b/docs/handbook/meta/index.md @@ -1,7 +1,12 @@ # Handbook Meta -!!! abstract "Placeholder Page" - This is a placeholder page. Please see the site navigation for any sub-pages that exist. +This Meta section is for information about this `about.starcat.systems` site itself. + +## Material for MkDocs +This site is written in Markdown and is generated using [:simple-materialformkdocs: Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) Insiders. The source Markdown is stored in the [:simple-forgejo: about Git repo](https://git.starcat.systems/starcatsys/about). + +## Editing +If you're looking for information about editing this site, please see [:octicons-arrow-right-16: Editing](editing.md). For specific Markdown syntax you can use with Material for MkDocs, please see [:octicons-arrow-right-16: Syntax](syntax.md). --- From a67f992d921f1f7ac2012a9f00a66fbf195de53f Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 22:19:52 -0400 Subject: [PATCH 17/17] Remove Forgejo last commit badge from README.md --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index 60a3ba3..316bb37 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,6 @@ This repo contains the source Markdown and MkDocs files that generate [about.starcat.systems](https://about.starcat.systems) using [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/). -[![Gitea Last Commit](https://img.shields.io/gitea/last-commit/starcatsys/about?display_timestamp=committer&gitea_url=https%3A%2F%2Fgit.starcat.systems&style=flat&logo=git&logoColor=fff&logoSize=auto)](https://git.starcat.systems/starcatsys/about_docs/) ## Contributing