Skip to content
Snippets Groups Projects
Commit c59a3bf5 authored by Ribbon's avatar Ribbon :speech_balloon:
Browse files

Improve FAQ, fixes on grammar and tests on config.toml (WIP).

parent 86d3be1c
No related branches found
No related tags found
1 merge request!286Declutter of menu and many improvements.
Hide whitespace changes
Inline Side-by-side
config.toml
+ 4
− 8
View file @ c59a3bf5
...@@ -20,26 +20,22 @@ name = "FAQ" ...@@ -20,26 +20,22 @@ name = "FAQ"
url = "/faq" url = "/faq"
[[languages.en.menu.main]] [[languages.en.menu.main]]
weight = 3 weight = 3
name = "Quickstart"
url = "/quickstart/"
[[languages.en.menu.main]]
weight = 4
name = "News" name = "News"
url = "/news/" url = "/news/"
[[languages.en.menu.main]] [[languages.en.menu.main]]
weight = 5 weight = 4
name = "GitLab" name = "GitLab"
url = "https://gitlab.redox-os.org/redox-os/redox" url = "https://gitlab.redox-os.org/redox-os/redox"
[[languages.en.menu.main]] [[languages.en.menu.main]]
weight = 6 weight = 5
name = "Community" name = "Community"
url = "/community" url = "/community"
[[languages.en.menu.main]] [[languages.en.menu.main]]
weight = 7 weight = 6
name = "Donate" name = "Donate"
url = "/donate/" url = "/donate/"
[[languages.en.menu.main]] [[languages.en.menu.main]]
weight = 8 weight = 7
name = "RSoC" name = "RSoC"
url = "/rsoc/" url = "/rsoc/"
......
content/faq.en.md
+ 34
− 45
View file @ c59a3bf5
...@@ -27,7 +27,7 @@ This page covers the most asked questions. ...@@ -27,7 +27,7 @@ This page covers the most asked questions.
Redox is a microkernel-based operating system, a complete, fully-functioning, general-purpose operating system with a focus on safety, freedom, reliability, correctness, and pragmatism. Redox is a microkernel-based operating system, a complete, fully-functioning, general-purpose operating system with a focus on safety, freedom, reliability, correctness, and pragmatism.
Wherever possible, the system components are written in Rust and run in user-space Wherever possible, the system components are written in Rust and run in user-space.
## What features does Redox have? ## What features does Redox have?
...@@ -35,7 +35,7 @@ Wherever possible, the system components are written in Rust and run in user-spa ...@@ -35,7 +35,7 @@ Wherever possible, the system components are written in Rust and run in user-spa
#### True modularity #### True modularity
You can modify/change many system components without a system restart, similar to [livepatching]. You can modify/change many system components without a system restart, similar to but safer than [livepatching].
[livepatching]: https://en.wikipedia.org/wiki/Kpatch [livepatching]: https://en.wikipedia.org/wiki/Kpatch
...@@ -67,17 +67,15 @@ By isolating the system components from the kernel, the [attack surface] is very ...@@ -67,17 +67,15 @@ By isolating the system components from the kernel, the [attack surface] is very
#### Improved security and reliability without significant performance impact #### Improved security and reliability without significant performance impact
As the kernel is small, it uses less memory to do its work and close to bug-free status ([KISS] goal). As the kernel is small, it uses less memory to do its work and the limited kernel code helps keep it close to bug-free status ([KISS] goal).
Beyond being small, the system is written in Rust, this language helps the programmer to write better code that don't cause performance problems. Rust's safe and fast language design, combined with the small size of the kernel code base, helps ensure a reliable, performant and easy to maintain core.
Rust implement performance optimization with safety by default.
[KISS]: https://en.wikipedia.org/wiki/KISS_principle [KISS]: https://en.wikipedia.org/wiki/KISS_principle
#### Rust-written drivers #### Rust-written drivers
Drivers written in Rust have less bugs, more security and performance (less bugs can bring more performance of the device). Drivers written in Rust are likely to have fewer bugs, better security and performance (fewer bugs can bring more performance on the device).
- [Currently supported devices](/faq/#which-devices-redox-support) - [Currently supported devices](/faq/#which-devices-redox-support)
...@@ -93,7 +91,7 @@ Expect high performance and data safety (copy-on-write, data integrity, volumes, ...@@ -93,7 +91,7 @@ Expect high performance and data safety (copy-on-write, data integrity, volumes,
The main goal of Redox is to be a general-purpose OS for any kind of task/computer, while maintaining security, reliability and correctness. The main goal of Redox is to be a general-purpose OS for any kind of task/computer, while maintaining security, reliability and correctness.
We aim to be an alternative for existing Unix systems (Linux/BSD) too, with the ability to run Unix programs only minimal modifications. Redox aims to be an alternative for existing Unix systems (Linux/BSD), with the ability to run most Unix programs too, with only recompilation or minimal modifications.
[Our Goals] [Our Goals]
...@@ -101,7 +99,9 @@ We aim to be an alternative for existing Unix systems (Linux/BSD) too, with the ...@@ -101,7 +99,9 @@ We aim to be an alternative for existing Unix systems (Linux/BSD) too, with the
## What I can do with Redox? ## What I can do with Redox?
As a general-purpose operating system, you can do almost anything on most devices with high performance/security. As a general-purpose operating system, you will be able to do almost anything on most devices with high performance/security.
Redox is still under development, so our list of supported applications is currently limited, but growing.
[Use Cases] [Use Cases]
...@@ -159,7 +159,9 @@ Redox tries to implement the Linux performance improvements in a microkernel des ...@@ -159,7 +159,9 @@ Redox tries to implement the Linux performance improvements in a microkernel des
## What is a microkernel? ## What is a microkernel?
A microkernel is a OS core model with a small quantity of code running on the first privilege of the processor, this model of OS core brings more stability and security, with a small cost on performance. A microkernel is the near-minimum amount of software that can provide the mechanisms needed to implement an operating system, which run on the highest privilege of the processor.
This approach to OS design brings more stability and security, with a small cost on performance.
- [Redox Book explanation] - [Redox Book explanation]
...@@ -167,9 +169,9 @@ A microkernel is a OS core model with a small quantity of code running on the fi ...@@ -167,9 +169,9 @@ A microkernel is a OS core model with a small quantity of code running on the fi
## What programs can Redox run? ## What programs can Redox run?
Unix/POSIX programs, Redox is source-compatible with Linux too (need to compile). Redox is designed to be source-compatible with most Unix, Linux and POSIX-compilant applications, only requiring compilation.
Some software need porting (recipes), as we don't support X11/Wayland yet, but SDL/Orbital. Currently, most GUI applications require porting, as we don't support X11 or Wayland yet.
Some important software that Redox support: Some important software that Redox support:
...@@ -183,12 +185,9 @@ Some important software that Redox support: ...@@ -183,12 +185,9 @@ Some important software that Redox support:
- [Python](https://gitlab.redox-os.org/redox-os/cookbook/-/tree/master/recipes/python) - [Python](https://gitlab.redox-os.org/redox-os/cookbook/-/tree/master/recipes/python)
- [SDL](https://gitlab.redox-os.org/redox-os/cookbook/-/tree/master/recipes/sdl2) - [SDL](https://gitlab.redox-os.org/redox-os/cookbook/-/tree/master/recipes/sdl2)
In the future the microkernel can act as a hypervisor, similar to [Xen]. You can see all Redox components/ported programs [here].
A [hypervisor] is a software that manage virtual machines, it can be a "compatibility layer" for any operating system. [here]: https://gitlab.redox-os.org/redox-os/cookbook/-/tree/master/recipes
[Xen]: https://xenproject.org/
[hypervisor]: https://en.wikipedia.org/wiki/Hypervisor
## Which devices does Redox support? ## Which devices does Redox support?
...@@ -277,20 +276,25 @@ There are billions of devices with hundreds of models/architectures in the world ...@@ -277,20 +276,25 @@ There are billions of devices with hundreds of models/architectures in the world
## Which virtual machines does Redox have integration with? ## Which virtual machines does Redox have integration with?
- [QEMU]
- [VirtualBox] - [VirtualBox]
- [Bochs]
[VirtualBox]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/vboxd In the future the microkernel can act as a hypervisor, similar to [Xen].
[Bochs]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/bgad
A [hypervisor] is a software that manage virtual machines, it can be a "compatibility layer" for any operating system.
[QEMU]: https://www.qemu.org/
[VirtualBox]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/vboxd
[Xen]: https://xenproject.org/
[hypervisor]: https://en.wikipedia.org/wiki/Hypervisor
## How do I build Redox? ## How do I build Redox?
Currently Redox has a bootstrap script Debian/Ubuntu/Pop OS! with unmaintained support for other distributions. Currently Redox has a bootstrap script for Debian/Ubuntu/Pop OS! with unmaintained support for other distributions.
We are moving to use Podman as our main compilation method, it is the recommended build process for non-Debian systems. We are moving to use Podman as our main compilation method, it is the recommended build process for non-Debian systems.
(Podman avoid environment problems on compilation) (Podman avoids environment problems on compilation)
- [Redox Book Guide] - (Debian/Ubuntu/Pop OS!) - [Redox Book Guide] - (Debian/Ubuntu/Pop OS!)
- [Redox Book Advanced Guide] - (Debian/Ubuntu/Pop OS!) - [Redox Book Advanced Guide] - (Debian/Ubuntu/Pop OS!)
...@@ -302,14 +306,6 @@ We are moving to use Podman as our main compilation method, it is the recommende ...@@ -302,14 +306,6 @@ We are moving to use Podman as our main compilation method, it is the recommende
[Redox Book Podman Guide]: https://doc.redox-os.org/book/ch02-06-podman-build.html [Redox Book Podman Guide]: https://doc.redox-os.org/book/ch02-06-podman-build.html
[Redox Book Podman Advanced Guide]: https://doc.redox-os.org/book/ch08-02-advanced-podman-build.html [Redox Book Podman Advanced Guide]: https://doc.redox-os.org/book/ch08-02-advanced-podman-build.html
### How to update the sources and compile the changes
If you already downloaded Redox sources and compiled, it's very easy to fetch/rebuild new changes.
- [Redox Book Rebuild Guide]
[Redox Book Rebuild Guide]: https://doc.redox-os.org/book/ch09-02-coding-and-building.html#the-full-rebuild-cycle
### How to launch QEMU without GUI ### How to launch QEMU without GUI
Run: Run:
...@@ -318,20 +314,12 @@ Run: ...@@ -318,20 +314,12 @@ Run:
QEMU terminal will looks like a container/chroot. QEMU terminal will looks like a container/chroot.
### How to insert files inside Redox QEMU harddisk
If you want to do quick changes/testing on QEMU image.
- [Redox Book QEMU Guide]
[Redox Book QEMU Guide]: https://doc.redox-os.org/book/ch09-02-coding-and-building.html#patch-an-image
### How to troubleshoot your build in case of errors ### How to troubleshoot your build in case of errors
Read all the Redox Book before to see if the problem is your build configuration or toolchain, if it don't fix your error, read: Refer to the Redox Book before to see if the problem is your build configuration or toolchain, if you still have problems, see the following or join us on [Redox Chat](https://doc.redox-os.org/book/ch13-01-chat.html).
- [Redox Book Troubleshooting Guide]
- [GitLab Troubleshooting Guide] - [GitLab Troubleshooting Guide]
- [Redox Book Troubleshooting Guide]
[Redox Book Troubleshooting Guide]: https://doc.redox-os.org/book/ch08-05-troubleshooting.html [Redox Book Troubleshooting Guide]: https://doc.redox-os.org/book/ch08-05-troubleshooting.html
[GitLab Troubleshooting Guide]: https://gitlab.redox-os.org/redox-os/redox#help-redox-wont-compile [GitLab Troubleshooting Guide]: https://gitlab.redox-os.org/redox-os/redox#help-redox-wont-compile
...@@ -341,6 +329,7 @@ Read all the Redox Book before to see if the problem is your build configuration ...@@ -341,6 +329,7 @@ Read all the Redox Book before to see if the problem is your build configuration
Check GitLab Issues first to see if your problem is already known. Check GitLab Issues first to see if your problem is already known.
- [Redox Book Bug Report Guide] - [Redox Book Bug Report Guide]
- [CONTRIBUTING.md](https://gitlab.redox-os.org/redox-os/redox/-/blob/master/CONTRIBUTING.md)
[Redox Book Bug Report Guide]: https://doc.redox-os.org/book/ch12-03-creating-proper-bug-reports.html [Redox Book Bug Report Guide]: https://doc.redox-os.org/book/ch12-03-creating-proper-bug-reports.html
...@@ -348,10 +337,10 @@ Check GitLab Issues first to see if your problem is already known. ...@@ -348,10 +337,10 @@ Check GitLab Issues first to see if your problem is already known.
You can contribute to Redox in many ways, here some of them: You can contribute to Redox in many ways, here some of them:
- [GitLab Guide]
- [Documentation](/docs/) - [Documentation](/docs/)
- [Redox Book Contribution Guide] - [Redox Book Contribution Guide]
- [How to make pull requests properly] - [How to make pull requests properly]
- [GitLab Guide]
- [Redox Dev room] - [Redox Dev room]
[Redox Book Contribution Guide]: https://doc.redox-os.org/book/ch10-02-low-hanging-fruit.html [Redox Book Contribution Guide]: https://doc.redox-os.org/book/ch10-02-low-hanging-fruit.html
...@@ -361,10 +350,10 @@ You can contribute to Redox in many ways, here some of them: ...@@ -361,10 +350,10 @@ You can contribute to Redox in many ways, here some of them:
## I have a problem/question for Redox team ## I have a problem/question for Redox team
- Read all the [Documentation](/docs/) page. - Have a look at the [Documentation](/docs/) page for more details of Redox internals.
- Read all the [Redox book] to see if it answer your questions/fix your problem. - Have a look at the [Redox Book] to see if it answers your questions/fixes your problem.
- If the book is not enough for you, make your question/say your problem in [Redox Support] or [Redox Dev] rooms on Matrix. - If the book does not answer your question, ask your question/say your problem in [Redox Support] or [Redox Dev] rooms on Matrix.
[Redox book]: https://doc.redox-os.org/book/ [Redox Book]: https://doc.redox-os.org/book/
[Redox Support]: https://matrix.to/#/#redox-support:matrix.org [Redox Support]: https://matrix.to/#/#redox-support:matrix.org
[Redox Dev]: https://matrix.to/#/#redox-dev:matrix.org [Redox Dev]: https://matrix.to/#/#redox-dev:matrix.org
content/screens.en.md
+ 4
− 1
View file @ c59a3bf5
...@@ -18,4 +18,7 @@ title = "Redox in Action" ...@@ -18,4 +18,7 @@ title = "Redox in Action"
<img class="img-responsive" src="/img/hardware/T520-P50-Asus-Desktop.jpg"/> <img class="img-responsive" src="/img/hardware/T520-P50-Asus-Desktop.jpg"/>
## Redox OS playing Stargate SG-1 Season 10 intro ## Redox OS playing Stargate SG-1 Season 10 intro
<video class="img-responsive" src="https://www.youtube.com/watch?v=3cPekY4c9Hc"/> <iframe width="560" height="315" src="https://www.youtube.com/embed/3cPekY4c9Hc" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
## Redox OS running Mesa3D Gears with LLVMpipe
<iframe width="560" height="315" src="https://www.youtube.com/embed/ADSvEA_YY7E" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
\ No newline at end of file
content/screens.pt.md
+ 5
− 2
View file @ c59a3bf5
...@@ -17,5 +17,8 @@ title = "Redox em Ação" ...@@ -17,5 +17,8 @@ title = "Redox em Ação"
## ThinkPad T520, ThinkPad P50 and Asus P7P55D-E Pro Desktop ## ThinkPad T520, ThinkPad P50 and Asus P7P55D-E Pro Desktop
<img class="img-responsive" src="/img/hardware/T520-P50-Asus-Desktop.jpg"/> <img class="img-responsive" src="/img/hardware/T520-P50-Asus-Desktop.jpg"/>
## Redox OS playing Stargate SG-1 Season 10 intro ## Redox OS reproduzindo a intro da temporada 10 de Stargate SG-1
<video class="img-responsive" src="https://www.youtube.com/watch?v=3cPekY4c9Hc"/> <iframe width="560" height="315" src="https://www.youtube.com/embed/3cPekY4c9Hc" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
\ No newline at end of file
## Redox OS executando Mesa3D Gears com LLVMpipe
<iframe width="560" height="315" src="https://www.youtube.com/embed/ADSvEA_YY7E" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
\ No newline at end of file
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment