summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAndreas Kling <kling@serenityos.org>2021-05-05 20:03:02 +0200
committerAndreas Kling <kling@serenityos.org>2021-05-05 20:03:02 +0200
commit773c17b6a0cb6cac1a40fccb6f285fe027497ff7 (patch)
tree9138d045df120a272b9a7b1043441d258a83344d
parenta51113c58ef88a5a762cbb19667d1250e67fb37a (diff)
downloadserenity-773c17b6a0cb6cac1a40fccb6f285fe027497ff7.zip
Documentation: Update FAQ a bit and move it into Documentation/
This was hiding on the serenityos.org website previously, where not many people found it. Let's put it in a more natural location, and also make sure to link to it from the README.
-rw-r--r--Documentation/FAQ.md27
-rw-r--r--README.md3
2 files changed, 29 insertions, 1 deletions
diff --git a/Documentation/FAQ.md b/Documentation/FAQ.md
new file mode 100644
index 0000000000..37ad729c52
--- /dev/null
+++ b/Documentation/FAQ.md
@@ -0,0 +1,27 @@
+# Frequently Asked Questions about SerenityOS
+
+## Will SerenityOS support `$THING`?
+
+Maybe. Maybe not. There is no plan.
+
+## When will you implement `$THING`?
+
+Maybe someday. Maybe never. If you want to see something happen, you can do it yourself!
+
+## Where are the ISO images?
+
+There are no ISO images. This project does not cater to non-technical users.
+
+## Why is the system 32-bit?
+
+That's what Andreas was most familiar with when starting out. There's some interest in supporting 64-bit systems and that will eventually happen, but it's just another feature.
+
+## I did a `git pull` and now the build is broken! What do I do?
+
+If it builds on CI, it should build for you too. You may need to rebuild the toolchain. If that doesn't help, try it with a clean repo.
+
+If you can't figure out what to do, ask in the `#build-problems` channel on Discord.
+
+## Why don't you use `$LIBRARY` instead of implementing `$FEATURE` yourself?
+
+The SerenityOS project tries to maximize hackability, accountability, and fun(!) by implementing everything ourselves. \ No newline at end of file
diff --git a/README.md b/README.md
index 1e41f468a8..80a071eb60 100644
--- a/README.md
+++ b/README.md
@@ -97,13 +97,14 @@ See the [SerenityOS build instructions](https://github.com/SerenityOS/serenity/b
Please see the [issue policy](https://github.com/SerenityOS/serenity/blob/master/CONTRIBUTING.md#issue-policy).
+FAQ: [Frequently Asked Questions](https://github.com/SerenityOS/serenity/blob/master/FAQ.md)
+
## Get in touch
IRC: `#serenityos` on the Freenode IRC network.
Discord: [SerenityOS Discord](https://discord.com/invite/29gCcKsXkF)
-
## Author
* **Andreas Kling** - [awesomekling](https://twitter.com/awesomekling)