From 125c0644668a2df9ec9bd0bec5722155550b9393 Mon Sep 17 00:00:00 2001 From: Christoph Haas Date: Tue, 24 Dec 2024 19:31:49 +0100 Subject: [PATCH] Added contact link. Extended FAQ. --- src/components/Footer.astro | 4 ++-- src/content/docs/index.mdx | 3 +++ src/content/docs/ispmail-bookworm/260-faq.mdx | 19 ++++++++++++++----- 3 files changed, 19 insertions(+), 7 deletions(-) diff --git a/src/components/Footer.astro b/src/components/Footer.astro index 90250c4..3b49a43 100644 --- a/src/components/Footer.astro +++ b/src/components/Footer.astro @@ -14,9 +14,9 @@ import Default from "@astrojs/starlight/components/Footer.astro"; }
- This guide is maintained by Christoph Haas since 2003. All content on workaround.org can be used under the terms of + This guide is maintained by Christoph Haas since 2003. All content on workaround.org can be used under the terms of the Creative Commons BY-NC-SA license. - Penguin images based on AI art because I suck at drawing. + Penguin image based on AI art because I suck at drawing.
diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx index de78d53..8038a84 100644 --- a/src/content/docs/index.mdx +++ b/src/content/docs/index.mdx @@ -10,6 +10,9 @@ hero: - text: Let's build your mail server… link: /ispmail-bookworm icon: rocket +# banner: +# content: | +# This guide has been re-done. --- import { Card, CardGrid } from '@astrojs/starlight/components'; diff --git a/src/content/docs/ispmail-bookworm/260-faq.mdx b/src/content/docs/ispmail-bookworm/260-faq.mdx index 8c4a999..809fa37 100644 --- a/src/content/docs/ispmail-bookworm/260-faq.mdx +++ b/src/content/docs/ispmail-bookworm/260-faq.mdx @@ -17,7 +17,7 @@ Besides that this guide has been a team effort. Many readers have contributed to ## Can I advertise in your guide? -No. +No. There is no financial motivation. I just strive for freeing the world of email services once again. ## Why don’t you use Nginx/PostgreSQL? @@ -25,7 +25,7 @@ I personally prefer that software, too. Just go for it. But for the sake of cons ## Do you offer paid support? -Generally, yes, I am a sysadmin freelancer. If you are just stuck at some point you may want to ask in the [chat](https://riot.im/app/#/room/#ispmail:matrix.org) first though. +Generally, yes. Aside from my day job, I am a sysadmin freelancer. If you are just stuck at some point you may want to ask in the [chat](https://riot.im/app/#/room/#ispmail:matrix.org) first though. You can find me there as well. ## How do I filter out malware? @@ -37,8 +37,17 @@ If you use a Debian stable release you have chosen to stay on a specific softwar ## Can I download the guide as one file? -I haven’t yet found a way to accomplish that. WordPress is not especially good when it comes to structured multi-page documentation. If anyone has a hint I’d be grateful. +Unfortunately there is no easy way to accomplish that. Especially with interactive components like tabs of quizzes. The reasons are technical – not malice. -## Why don’t you put the guide on Github as Markdown? +## Your guide looks cool. How did you make it? -This website runs on WordPress because I wanted something easy to edit and also have discussions on each page. I might be a hardcore terminal user but just sometimes I prefer to have a WYSIWYG editor. I tried several ways to work with multi-file Markdown builders but the workflow was uncomfortable and lead to ugly documentation. Besides we wouldn’t have discussions on the pages and I’m surely not including Quora for discussions. \ No newline at end of file +The site is generated using [Starlight](https://starlight.astro.build/). Discussions at the bottom of each page are powered by [Comentario](https://comentario.app/). +Diagrams have been created using [Inkscape](https://inkscape.org/). User tracking is handled by [Matomo](https://matomo.org/). +Everything here has been generated using open-source software and is not using any public cloud services. + +## I can offer to translate your guide. + +That is very kind to offer help. I understand the motivation to give back something. But trust me: you will lose interest quickly and regret your offer. +The guide is huge. It may not appear like much but once you start typing you realize just how many months of work went into it. +Even translating will take 1-2 weeks of your time. And after that someone would have to maintain both the original version and your translation. +We tried that a couple of times and it did not turn out well.