Updating wiki dates, adding the bugs page

This commit is contained in:
ngn 2024-02-22 23:16:30 +03:00
parent c475fd9916
commit a015cca9f2
14 changed files with 95 additions and 10 deletions

View File

@ -1,3 +1,3 @@
{ {
"title": "24.00" "title": "24.01"
} }

View File

@ -2,5 +2,5 @@
"id": "install", "id": "install",
"title": "Installation", "title": "Installation",
"author": "ngn", "author": "ngn",
"date": "17/01/24" "date": "22/02/24"
} }

View File

@ -102,6 +102,22 @@ Link `/etc/localtime` to your localtime zone. Timezones are located under
# ln -sf /usr/share/zoneinfo/Europe/Istanbul /etc/localtime # ln -sf /usr/share/zoneinfo/Europe/Istanbul /etc/localtime
``` ```
### Setup Locales
List all the avaliable locales with `locale -a`, then place the locale you want into the
`/etc/locale.gen` file with the following format:
```
full_locale_name UTF-8
```
For example:
```
en_US.UTF-8 UTF-8
```
Then run the `locale-gen` command to generate all the locales. Lastly place the locale of your choice
into the `/etc/locale.conf` file, for example:
```
# echo "LANG=en_US.UTF-8" > /etc/locale.conf
```
### Installing Important Packages ### Installing Important Packages
After changing root, you can now start installing other base system packages that are not included in the release archive. After changing root, you can now start installing other base system packages that are not included in the release archive.

View File

@ -2,5 +2,5 @@
"id": "post_install", "id": "post_install",
"title": "Post-Installation", "title": "Post-Installation",
"author": "ngn", "author": "ngn",
"date": "19/01/24" "date": "22/01/24"
} }

View File

@ -22,9 +22,43 @@ You can enable root login, by editing `/etc/ssh/sshd_config`:
PermitRootLogin yes PermitRootLogin yes
``` ```
## Adding new users
To add a new user, use the `useradd` command:
```
# useradd -m <username>
```
You may want to configure `doas` to provide root access to the new user.
To do this, install the `doas` package:
```
# mp-install doas
```
Then create a group named `wheel` for all the admin users:
```
# groupadd wheel
```
Add your user to the `wheel` group:
```
# usermod -aG wheel <username>
```
Lastly edit the doas confiuration (`/etc/doas.conf`) to give access to the `wheel` group users:
```
# echo "permit keepenv :wheel" > /etc/doas.conf
```
## Installing XORG ## Installing XORG
Xorg can be installed using a simple wrapper package: Xorg can be installed using a simple wrapper package:
``` ```
# mp-install xorg # mp-install xorg
``` ```
Then you can use `startx` to start the `xorg-server`. Then you can use `startx` to start the `xorg-server`.
## Installing a desktop
To easily install a desktop, you can use the `xcfg` tool:
```
# mp-install xcfg
```
You can then use the tool as a regular user, not that you will need access to the `doas` (or `sudo`) command
in order to use the tool:
```
$ xcfg
```

View File

@ -22,4 +22,5 @@ edit a page or create a new page, make a [pull request](/wiki/contribute) to [co
| -------------------------------- | ------------------------------------------------------- | | -------------------------------- | ------------------------------------------------------- |
| [Chat](/wiki/chat) | Learn how you can contact developers and users | | [Chat](/wiki/chat) | Learn how you can contact developers and users |
| [Contributing](/wiki/contribute) | Learn how you can contribute to MatterLinux | | [Contributing](/wiki/contribute) | Learn how you can contribute to MatterLinux |
| [Bugs](/wiki/bugs) | Learn how you can report bugs/issues |
| [Licensing](/wiki/licensing) | Licensing for the MatterLinux repositories and software | | [Licensing](/wiki/licensing) | Licensing for the MatterLinux repositories and software |

6
wiki/other/bugs.json Normal file
View File

@ -0,0 +1,6 @@
{
"id": "chat",
"title": "Chat",
"author": "ngn",
"date": "22/02/24"
}

26
wiki/other/bugs.md Normal file
View File

@ -0,0 +1,26 @@
As an user or a developer, reporting the bugs you find is really important
for the project. On this page you will find information about how you can report
bugs to the project.
## Package bugs/issues
If you are having issues with a package/software, identify the repo contains the package.
You can use the `mp-query` command for this.
After identifying the repo, visit the issue tracker for that specific repo:
- [issue tracker for the `base` repo](https://git.matterlinux.xyz/Matter/base/issues)
- [issue tracker for the `desktop` repo](https://git.matterlinux.xyz/Matter/desktop/issues)
Using the search feature of the issue tracker, make sure that the issue has not been already reported.
There is no point at reporting the issue, if it has been already reported. Duplicate issues will be closed.
If the issue has not been already reported, follow the "Registering to Gitea" section of the [contributing page](/wiki/contribute)
in order to create an account. Using this account you can create an issue, fill out all the required information,
and patiently wait for a response. You should provide additional details about the bug/issue when requested.
## Tool bugs/issues
You may have issues using MatterLinux tools such as the MatterLinux Package Manager (`mp`). This issues should be reported
to the related issue tracker over on [Gitea](https://git.matterlinux.xyz/Matter).
## Translation mistakes, spelling mistakes etc.
You do not need to create an issue for small issues such as little translation mistakes. Just contact maintainer/developers
on [XMPP](/wiki/chat).

View File

@ -2,5 +2,5 @@
"id": "contribute", "id": "contribute",
"title": "Contributing", "title": "Contributing",
"author": "ngn", "author": "ngn",
"date": "12/01/24" "date": "22/02/24"
} }

View File

@ -8,7 +8,7 @@ contribute, you should register an account first. To prevent mass account creati
page of Gitea is disabled. So in order to register an account, send a email to the page of Gitea is disabled. So in order to register an account, send a email to the
[maintainer](mailto:ngn@ngn.tf) with the subject `Gitea Account`. Specify **at least** two usernames [maintainer](mailto:ngn@ngn.tf) with the subject `Gitea Account`. Specify **at least** two usernames
for your account (second one will be used for registration if the first one is unavailable). Then for your account (second one will be used for registration if the first one is unavailable). Then
wait for a reply containing further instructions. wait for a reply containing further instructions. You can also contact the maintainer over on [XMPP](/wiki/chat).
> **Important** > **Important**
> >
@ -21,6 +21,8 @@ To report a bug, to ask questions or to request a feature, first find the relate
Then head over to the issue tab. Label your issue and explain it with a simple title. Write a Then head over to the issue tab. Label your issue and explain it with a simple title. Write a
detailed description for the issue. Finally create the issue and patiently wait for a response. detailed description for the issue. Finally create the issue and patiently wait for a response.
To get more information about reporting bugs, check out [this wiki page](/wiki/bugs).
## Pull Requests ## Pull Requests
If you want to make changes and merge them to the project, first fork the related repository. If you want to make changes and merge them to the project, first fork the related repository.
Then clone the forked repository and make the changes you want. Then clone the forked repository and make the changes you want.
@ -75,7 +77,7 @@ syntax on
After making the changes, commit them using the following format: After making the changes, commit them using the following format:
``` ```
<fix/feature>: <description> <fix/feature/new/remove/update>: <description>
``` ```
Do not use long commit messages, instead add a description to your commit if needed. **Make sure the email you are Do not use long commit messages, instead add a description to your commit if needed. **Make sure the email you are
using for signing the commit matches with your Gitea account email.** using for signing the commit matches with your Gitea account email.**

View File

@ -2,5 +2,5 @@
"id": "mirrors", "id": "mirrors",
"title": "Mirrors", "title": "Mirrors",
"author": "ngn", "author": "ngn",
"date": "12/01/24" "date": "21/02/24"
} }

View File

@ -2,5 +2,5 @@
"id": "package_man", "id": "package_man",
"title": "Package Management", "title": "Package Management",
"author": "ngn", "author": "ngn",
"date": "15/01/24" "date": "21/02/24"
} }

View File

@ -2,5 +2,5 @@
"id": "release", "id": "release",
"title": "Releases", "title": "Releases",
"author": "ngn", "author": "ngn",
"date": "15/01/24" "date": "21/02/24"
} }

View File

@ -2,5 +2,5 @@
"id": "repo", "id": "repo",
"title": "Repo", "title": "Repo",
"author": "ngn", "author": "ngn",
"date": "11/01/24" "date": "21/02/24"
} }