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

FAQ/Documentation improvements.

parent e056f0ee
No related branches found
No related tags found
1 merge request!276FAQ/Documentation improvements.
Hide whitespace changes
Inline Side-by-side
content/docs.en.md
+ 14
− 7
View file @ cb4d1f62
...@@ -20,13 +20,20 @@ We highly recommend that you start with the [Book](https://doc.redox-os.org/book ...@@ -20,13 +20,20 @@ We highly recommend that you start with the [Book](https://doc.redox-os.org/book
## Contributing to Redox ## Contributing to Redox
Thank you for your interest in contributing to Redox! You can contribute to Redox documentation/code on these repositories:
There are many ways to help us out and we appreciate all of them.
(The order is based on difficulty, easy things first)
Redox is a large project spread out across many repos which can be found in the
[Redox organization on GitLab](https://gitlab.redox-os.org/redox-os). This document, - [Website](https://gitlab.redox-os.org/redox-os/website)
[CONTRIBUTING.md](https://gitlab.redox-os.org/redox-os/redox/blob/master/CONTRIBUTING.md) - [Book](https://gitlab.redox-os.org/redox-os/book)
is a guide to help newcomers contribute! - [Scripts/Config](https://gitlab.redox-os.org/redox-os/redox)
- [Redox Packages (all system components/ported software)](https://gitlab.redox-os.org/redox-os/cookbook)
- [Redox Desktop Environment](https://gitlab.redox-os.org/redox-os/orbital)
- [Orbital Client Library](https://gitlab.redox-os.org/redox-os/orbclient)
- [Orbital Applications](https://gitlab.redox-os.org/redox-os/orbutils)
- [Redox C Library](https://gitlab.redox-os.org/redox-os/relibc)
- [Drivers](https://gitlab.redox-os.org/redox-os/drivers)
- [Kernel](https://gitlab.redox-os.org/redox-os/kernel)
## Communication and Chat ## Communication and Chat
......
content/docs.pt.md
+ 15
− 6
View file @ cb4d1f62
...@@ -20,12 +20,21 @@ Nós recomendamos que você comece pelo [Livro](https://doc.redox-os.org/book/), ...@@ -20,12 +20,21 @@ Nós recomendamos que você comece pelo [Livro](https://doc.redox-os.org/book/),
## Contribuindo pro Redox ## Contribuindo pro Redox
Muito obrigado pelo seu interesse em contribuir pro Redox! Você pode contribuir para a documentação/código do Redox nestes repositórios:
Existem muitas formas de nos ajudar e nós somos gratos por qualquer ajuda.
(The order is based on difficulty, easy things first)
O Redox é um grande projeto distribuído através de muitos repositórios que se encontram na (A ordem é baseada na dificuldade, coisas fáceis primeiro)
[organização Redox no GitLab](https://gitlab.redox-os.org/redox-os). O documento [CONTRIBUTING.md](https://gitlab.redox-os.org/redox-os/redox/blob/master/CONTRIBUTING.md)
é um guia para ajudar os recém-chegados a contribuir. - [Site](https://gitlab.redox-os.org/redox-os/website)
- [Livro](https://gitlab.redox-os.org/redox-os/book)
- [Scripts/Configuração](https://gitlab.redox-os.org/redox-os/redox)
- [Pacotes do Redox (todos os componentes do sistema/softwares portados)](https://gitlab.redox-os.org/redox-os/cookbook)
- [Ambiente de Desktop do Redox](https://gitlab.redox-os.org/redox-os/orbital)
- [Biblioteca de Cliente do Orbital](https://gitlab.redox-os.org/redox-os/orbclient)
- [Aplicações do Orbital](https://gitlab.redox-os.org/redox-os/orbutils)
- [Biblioteca C do Redox](https://gitlab.redox-os.org/redox-os/relibc)
- [Drivers](https://gitlab.redox-os.org/redox-os/drivers)
- [Kernel](https://gitlab.redox-os.org/redox-os/kernel)
## Comunicação e Chat ## Comunicação e Chat
......
content/faq.en.md
+ 37
− 30
View file @ cb4d1f62
...@@ -10,13 +10,13 @@ This page covers the most asked questions. ...@@ -10,13 +10,13 @@ This page covers the most asked questions.
- [Which devices Redox support?](#which-devices-redox-support) - [Which devices Redox support?](#which-devices-redox-support)
- [Which virtual machines Redox has integration?](#which-virtual-machines-redox-has-integration) - [Which virtual machines Redox has integration?](#which-virtual-machines-redox-has-integration)
- [How to build Redox?](#how-to-build-redox) - [How to build Redox?](#how-to-build-redox)
- [How to report bugs on Redox?](#how-to-report-bugs-on-redox)
- [How to contribute for Redox?](#how-to-contribute-for-redox)
- [I have a problem/question for Redox team](#i-have-a-problemquestion-for-redox-team)
- [How to update the sources and compile the changes?](#how-to-update-the-sources-and-compile-the-changes) - [How to update the sources and compile the changes?](#how-to-update-the-sources-and-compile-the-changes)
- [How to launch QEMU without GUI](#how-to-launch-qemu-without-gui)
- [How to insert files inside Redox QEMU harddisk](#how-to-insert-files-inside-redox-qemu-harddisk) - [How to insert files inside Redox QEMU harddisk](#how-to-insert-files-inside-redox-qemu-harddisk)
- [How to troubleshoot your build in case of errors](#how-to-troubleshoot-your-build-in-case-of-errors) - [How to troubleshoot your build in case of errors](#how-to-troubleshoot-your-build-in-case-of-errors)
- [How to launch QEMU without GUI](#how-to-launch-qemu-without-gui) - [How to report bugs on Redox?](#how-to-report-bugs-on-redox)
- [How to contribute for Redox?](#how-to-contribute-for-redox)
- [I have a problem/question for Redox team](#i-have-a-problemquestion-for-redox-team)
## What is an Unix-like OS? ## What is an Unix-like OS?
...@@ -163,6 +163,7 @@ Redox tries to implement the Linux performance improvements in a microkernel des ...@@ -163,6 +163,7 @@ Redox tries to implement the Linux performance improvements in a microkernel des
[VirtualBox]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/vboxd [VirtualBox]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/vboxd
[Bochs]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/bgad [Bochs]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/bgad
## How to build Redox? ## How to build Redox?
Currently Redox has a bootstrap script Debian/Ubuntu/Pop OS! with unmaintained support for other distributions. Currently Redox has a bootstrap script Debian/Ubuntu/Pop OS! with unmaintained support for other distributions.
...@@ -181,6 +182,34 @@ We are moving to use Podman as our main compilation method, actually it's mature ...@@ -181,6 +182,34 @@ We are moving to use Podman as our main compilation method, actually it's mature
[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?
- [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
Run:
- `make qemu vga=no`
QEMU terminal will looks like a container/chroot.
## How to insert files inside Redox QEMU harddisk
- [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
- [Redox Book Troubleshooting Guide]
- [GitLab Troubleshooting Guide]
[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
## How to report bugs on Redox? ## How to report bugs on Redox?
- [Redox Book Bug Report Guide] - [Redox Book Bug Report Guide]
...@@ -189,45 +218,23 @@ We are moving to use Podman as our main compilation method, actually it's mature ...@@ -189,45 +218,23 @@ We are moving to use Podman as our main compilation method, actually it's mature
## How to contribute for Redox? ## How to contribute for Redox?
- [Documentation](/docs/)
- [Redox Book Contribution Guide] - [Redox Book Contribution Guide]
- [How to make pull requests properly] - [How to make pull requests properly]
- [GitLab Guide] - [GitLab Guide]
- [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
[How to make pull requests properly]: https://doc.redox-os.org/book/ch12-04-creating-proper-pull-requests.html [How to make pull requests properly]: https://doc.redox-os.org/book/ch12-04-creating-proper-pull-requests.html
[GitLab Guide]: https://gitlab.redox-os.org/redox-os/redox/blob/master/CONTRIBUTING.md [GitLab Guide]: https://gitlab.redox-os.org/redox-os/redox/blob/master/CONTRIBUTING.md
[Redox Dev room]: https://matrix.to/#/#redox-dev:matrix.org
## I have a problem/question for Redox team ## I have a problem/question for Redox team
- Read all the [Documentation](/docs/) page.
- Read all the [Redox book] to see if it answer your questions/fix your problem. - Read all the [Redox book] to see if it answer your questions/fix 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 is not enough for you, make 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
## How to update the sources and compile the 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 insert files inside Redox QEMU harddisk
- [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
- [Redox Book Troubleshooting Guide]
- [GitLab Troubleshooting Guide]
[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
## How to launch QEMU without GUI
- Run `make qemu vga=no`
QEMU terminal will looks like a container/chroot.
content/faq.pt.md
+ 36
− 31
View file @ cb4d1f62
...@@ -11,14 +11,13 @@ Essa página cobre as perguntas mais comuns. ...@@ -11,14 +11,13 @@ Essa página cobre as perguntas mais comuns.
- [Quais dispositivos o Redox suporta?](#quais-dispositivos-o-redox-suporta) - [Quais dispositivos o Redox suporta?](#quais-dispositivos-o-redox-suporta)
- [Quais máquinas virtuais o Redox possui integração?](#quais-m%C3%A1quinas-virtuais-o-redox-possui-integra%C3%A7%C3%A3o) - [Quais máquinas virtuais o Redox possui integração?](#quais-m%C3%A1quinas-virtuais-o-redox-possui-integra%C3%A7%C3%A3o)
- [Como compilar o Redox?](#como-compilar-o-redox) - [Como compilar o Redox?](#como-compilar-o-redox)
- [Como reportar bugs para o Redox?](#como-reportar-bugs-para-o-redox)
- [Como contribuir para o Redox?](#como-contribuir-para-o-redox)
- [Eu tenho um problema/pergunta para a equipe do Redox](#eu-tenho-um-problemapergunta-para-a-equipe-do-redox)
- [Como atualizar o código-fonte e compilar as mudanças?](#como-atualizar-o-c%C3%B3digo-fonte-e-compilar-as-mudan%C3%A7as) - [Como atualizar o código-fonte e compilar as mudanças?](#como-atualizar-o-c%C3%B3digo-fonte-e-compilar-as-mudan%C3%A7as)
- [Como abrir o QEMU sem interface gráfica](#como-abrir-o-qemu-sem-interface-gr%C3%A1fica)
- [Como inserir arquivos no disco rígido do QEMU](#como-inserir-arquivos-dentro-do-disco-r%C3%ADgido-do-qemu) - [Como inserir arquivos no disco rígido do QEMU](#como-inserir-arquivos-dentro-do-disco-r%C3%ADgido-do-qemu)
- [Como diagnosticar seu Redox em caso de erros](#como-diagnosticar-seu-redox-em-caso-de-erros) - [Como diagnosticar seu Redox em caso de erros](#como-diagnosticar-seu-redox-em-caso-de-erros)
- [Como abrir o QEMU sem interface gráfica](#como-abrir-o-qemu-sem-interface-gr%C3%A1fica) - [Como reportar bugs para o Redox?](#como-reportar-bugs-para-o-redox)
- [Como contribuir para o Redox?](#como-contribuir-para-o-redox)
- [Eu tenho um problema/pergunta para a equipe do Redox](#eu-tenho-um-problemapergunta-para-a-equipe-do-redox)
## O que é um sistema Unix-like? ## O que é um sistema Unix-like?
...@@ -183,6 +182,34 @@ Nós estamos em transição para o Podman como nosso método de compilação pri ...@@ -183,6 +182,34 @@ Nós estamos em transição para o Podman como nosso método de compilação pri
[Guia do Podman no Livro do Redox]: https://doc.redox-os.org/book/ch02-06-podman-build.html [Guia do Podman no Livro do Redox]: https://doc.redox-os.org/book/ch02-06-podman-build.html
[Guia Avançado do Podman no Livro do Redox]: https://doc.redox-os.org/book/ch08-02-advanced-podman-build.html [Guia Avançado do Podman no Livro do Redox]: https://doc.redox-os.org/book/ch08-02-advanced-podman-build.html
## Como atualizar o código-fonte e compilar as mudanças?
- [Guia de Recompilação no Livro do Redox]
[Guia de Recompilação no Livro do Redox]: https://doc.redox-os.org/book/ch09-02-coding-and-building.html#the-full-rebuild-cycle
## Como abrir o QEMU sem interface gráfica
Execute:
- `make qemu vga=no`
O QEMU ficará semelhante a um container/chroot.
## Como inserir arquivos dentro do disco rígido do QEMU
- [Guia do QEMU no livro do Redox]
[Guia do QEMU no livro do Redox]: https://doc.redox-os.org/book/ch09-02-coding-and-building.html#patch-an-image
## Como diagnosticar seu Redox em caso de erros
- [Guia de Diagnóstico no Livro do Redox]
- [Guia de Diagnóstico no GitLab]
[Guia de Diagnóstico no Livro do Redox]: https://doc.redox-os.org/book/ch08-05-troubleshooting.html
[Guia de Diagnóstico no GitLab]: https://gitlab.redox-os.org/redox-os/redox#help-redox-wont-compile
## Como reportar bugs para o Redox? ## Como reportar bugs para o Redox?
- [Guia para Relatório de Bug no Livro do Redox] - [Guia para Relatório de Bug no Livro do Redox]
...@@ -191,45 +218,23 @@ Nós estamos em transição para o Podman como nosso método de compilação pri ...@@ -191,45 +218,23 @@ Nós estamos em transição para o Podman como nosso método de compilação pri
## Como contribuir para o Redox? ## Como contribuir para o Redox?
- [Documentação](/docs/)
- [Guia de Contribuição no Livro do Redox] - [Guia de Contribuição no Livro do Redox]
- [Como fazer pull requests corretamente] - [Como fazer pull requests corretamente]
- [Guia do GitLab] - [Guia do GitLab]
- [Sala de Desenvolvimento do Redox] - Nos diga o que você planeja fazer.
[Guia de Contribuição no Livro do Redox]: https://doc.redox-os.org/book/ch10-02-low-hanging-fruit.html [Guia de Contribuição no Livro do Redox]: https://doc.redox-os.org/book/ch10-02-low-hanging-fruit.html
[Como fazer pull requests corretamente]: https://doc.redox-os.org/book/ch12-04-creating-proper-pull-requests.html [Como fazer pull requests corretamente]: https://doc.redox-os.org/book/ch12-04-creating-proper-pull-requests.html
[Guia do GitLab]: https://gitlab.redox-os.org/redox-os/redox/blob/master/CONTRIBUTING.md [Guia do GitLab]: https://gitlab.redox-os.org/redox-os/redox/blob/master/CONTRIBUTING.md
[Sala de Desenvolvimento do Redox]: https://matrix.to/#/#redox-dev:matrix.org
## Eu tenho um problema/pergunta para a equipe do Redox ## Eu tenho um problema/pergunta para a equipe do Redox
- Leia a [Documentação](/docs/).
- Leia todo [livro do Redox] para ver se isso responde suas pergunta/corrige seu problema. - Leia todo [livro do Redox] para ver se isso responde suas pergunta/corrige seu problema.
- Se o livro não for suficiente pra você, diga sua pergunta/problema nas salas [Redox Support] ou [Redox Dev] no Matrix. - Se o livro não for suficiente pra você, diga sua pergunta/problema nas salas [Redox Support] ou [Redox Dev] no Matrix.
[livro do Redox]: https://doc.redox-os.org/book/ [livro do Redox]: 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
## Como atualizar o código-fonte e compilar as mudanças?
- [Guia de Recompilação no Livro do Redox]
[Guia de Recompilação no Livro do Redox]: https://doc.redox-os.org/book/ch09-02-coding-and-building.html#the-full-rebuild-cycle
## Como inserir arquivos dentro do disco rígido do QEMU
- [Guia do QEMU no livro do Redox]
[Guia do QEMU no livro do Redox]: https://doc.redox-os.org/book/ch09-02-coding-and-building.html#patch-an-image
## Como diagnosticar seu Redox em caso de erros
- [Guia de Diagnóstico no Livro do Redox]
- [Guia de Diagnóstico no GitLab]
[Guia de Diagnóstico no Livro do Redox]: https://doc.redox-os.org/book/ch08-05-troubleshooting.html
[Guia de Diagnóstico no GitLab]: https://gitlab.redox-os.org/redox-os/redox#help-redox-wont-compile
## Como abrir o QEMU sem interface gráfica
- Execute `make qemu vga=no`
O QEMU ficará semelhante a um container/chroot.
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment