Updating wiki dates, adding the bugs page
This commit is contained in:
parent
c475fd9916
commit
a015cca9f2
@ -1,3 +1,3 @@
|
|||||||
{
|
{
|
||||||
"title": "24.00"
|
"title": "24.01"
|
||||||
}
|
}
|
||||||
|
@ -2,5 +2,5 @@
|
|||||||
"id": "install",
|
"id": "install",
|
||||||
"title": "Installation",
|
"title": "Installation",
|
||||||
"author": "ngn",
|
"author": "ngn",
|
||||||
"date": "17/01/24"
|
"date": "22/02/24"
|
||||||
}
|
}
|
||||||
|
@ -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.
|
||||||
|
@ -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"
|
||||||
}
|
}
|
||||||
|
@ -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
|
||||||
|
```
|
||||||
|
@ -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
6
wiki/other/bugs.json
Normal file
@ -0,0 +1,6 @@
|
|||||||
|
{
|
||||||
|
"id": "chat",
|
||||||
|
"title": "Chat",
|
||||||
|
"author": "ngn",
|
||||||
|
"date": "22/02/24"
|
||||||
|
}
|
26
wiki/other/bugs.md
Normal file
26
wiki/other/bugs.md
Normal 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).
|
@ -2,5 +2,5 @@
|
|||||||
"id": "contribute",
|
"id": "contribute",
|
||||||
"title": "Contributing",
|
"title": "Contributing",
|
||||||
"author": "ngn",
|
"author": "ngn",
|
||||||
"date": "12/01/24"
|
"date": "22/02/24"
|
||||||
}
|
}
|
||||||
|
@ -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.**
|
||||||
|
@ -2,5 +2,5 @@
|
|||||||
"id": "mirrors",
|
"id": "mirrors",
|
||||||
"title": "Mirrors",
|
"title": "Mirrors",
|
||||||
"author": "ngn",
|
"author": "ngn",
|
||||||
"date": "12/01/24"
|
"date": "21/02/24"
|
||||||
}
|
}
|
||||||
|
@ -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"
|
||||||
}
|
}
|
||||||
|
@ -2,5 +2,5 @@
|
|||||||
"id": "release",
|
"id": "release",
|
||||||
"title": "Releases",
|
"title": "Releases",
|
||||||
"author": "ngn",
|
"author": "ngn",
|
||||||
"date": "15/01/24"
|
"date": "21/02/24"
|
||||||
}
|
}
|
||||||
|
@ -2,5 +2,5 @@
|
|||||||
"id": "repo",
|
"id": "repo",
|
||||||
"title": "Repo",
|
"title": "Repo",
|
||||||
"author": "ngn",
|
"author": "ngn",
|
||||||
"date": "11/01/24"
|
"date": "21/02/24"
|
||||||
}
|
}
|
||||||
|
Loading…
Reference in New Issue
Block a user