-
Notifications
You must be signed in to change notification settings - Fork 8
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #46 from MassOS-Linux/development
Release MassOS 2022.10
- Loading branch information
Showing
32 changed files
with
1,976 additions
and
3,115 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,3 @@ | ||
| [submodule "stage3/gnome"] | ||
| path = stage3/gnome | ||
| url = https://github.com/MassOS-Linux/MassOS-GNOME |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,47 +1,27 @@ | ||
| # Welcome To MassOS | ||
| Welcome to **MassOS**, a [free](https://github.com/MassOS-Linux/MassOS/wiki/MassOS-and-Free-Software) GNU/Linux operating system for x86_64 devices, which aims to be minimal and lightweight, without compromising features. It uses the [Xfce](https://xfce.org) desktop environment. | ||
|  | ||
| Please visit the MassOS website, https://massos.org, and/or the [About MassOS](https://github.com/MassOS-Linux/MassOS/wiki/About-MassOS) wiki page to learn more about MassOS and its goals. | ||
| # Not Based On Any Other Distro | ||
| MassOS is completely independent and built entirely from the ground up; it is not based on any other distribution. Due to not being dependent on another distribution, it is able to boast the latest and greatest in software versions. | ||
| # MassOS | ||
| This is the main source repository for the [MassOS](https://massos.org) operating system. | ||
|
|
||
| The MassOS base system itself already contains a large selection of software which should suit most users. Instead of using a "classic" package manager (although [one is currently in development](https://github.com/MassOS-Linux/masspkg)), the universal **Flatpak** package manager (complemented by the GUI Gnome Software centre) can be used to install GUI-based software. AppImages and (most) standalone binaries are also supported. Additionally, developer-orientated users may also wish to compile software themselves, since the necessary tools and headers are provided with the system. | ||
|  | ||
| # Installing MassOS | ||
| MassOS has a live CD ISO which can be used to try out MassOS and easily install it. | ||
| If you are an end-user, the following links may help you find what you're looking for: | ||
|
|
||
| Please see the [Installing MassOS](https://github.com/MassOS-Linux/MassOS/wiki/Installing-MassOS) wiki page for more information, and instructions on how to install MassOS. | ||
| - [MassOS Website](https://massos.org): The main MassOS website. | ||
| - [Download MassOS](https://massos.org/download.html): Contains direct download links for the latest version of MassOS. | ||
| - [About MassOS](https://github.com/MassOS-Linux/MassOS/wiki/About-MassOS): Provides information about the MassOS project. | ||
| - [Installing MassOS](https://github.com/MassOS-Linux/MassOS/wiki/Installing-MassOS): Information on how to install MassOS on your computer. | ||
| - [Post Installation](https://github.com/MassOS-Linux/MassOS/wiki/Post-Installation): Tips on how to make the most out of your MassOS installation, like installing software and using additional package managers. | ||
| - [Upgrading MassOS](https://github.com/MassOS-Linux/MassOS/wiki/Upgrading-MassOS): Information about upgrading your system to a newer version of MassOS. | ||
| - [MassOS Wiki](https://github.com/MassOS-Linux/MassOS/wiki): All MassOS documentation lives here. | ||
| - [Issues](https://github.com/MassOS-Linux/MassOS/issues): From here you can report bugs with MassOS and search for ones which have already been reported. | ||
|
|
||
| The latest release can be found at and downloaded from the [releases page](https://github.com/TheSonicMaster/MassOS/releases). | ||
| If you are a developer, the information below, as well as the following links may be helpful: | ||
|
|
||
| Some developers may also wish to [build MassOS themselves](https://github.com/MassOS-Linux/MassOS/wiki/Building-MassOS) using the scripts in this repo. This is not recommended for most users. | ||
| # About This Repo | ||
| This repo contains the scripts which are used to build the complete MassOS system. Most people won't want to run these. Instead, you can download the latest release tarball of MassOS from the [releases page](https://github.com/TheSonicMaster/MassOS/releases). | ||
| # Releases | ||
| The latest release of MassOS can be downloaded from the [releases page](https://github.com/TheSonicMaster/MassOS/releases). From there you can also view the release notes and check out past releases too. | ||
| - [Contributing](https://github.com/MassOS-Linux/MassOS/wiki/Contributing): Information about contributing to MassOS. | ||
| - [Building MassOS](https://github.com/MassOS-Linux/MassOS/wiki/Building-MassOS): Information about building MassOS from source. | ||
|
|
||
| Release numbers follow the format **YYYY.MM**. For example: the August 2021 release was **2021.08**. On a working MassOS system, you can check the version by running `massos-release`. There is a new release of MassOS roughly once or twice per month. New releases will usually include updated software. A new release in the same month as an existing release will typically be less major, and will have a version in the format **YYYY.MM.2**. To upgrade an existing MassOS installation, see [Upgrading MassOS](https://github.com/MassOS-Linux/MassOS/wiki/Upgrading-MassOS). | ||
| # Information for developers | ||
| A detailed description of how the MassOS build system works can be found at [Building MassOS](https://github.com/MassOS-Linux/MassOS/wiki/Building-MassOS). | ||
|
|
||
| Developers who wish to test out some of the latest in-development features for the next version MassOS can take a look at the [development branch](https://github.com/TheSonicMaster/MassOS/tree/development). | ||
| # Joining The Community | ||
| Main discussion happens in the `#tech-chat` channel of [this Discord Server](https://discord.gg/EfshNrt). You can also join it by clicking the link below: | ||
| This repository contains the source and build system for the core MassOS system (stage 1 and stage 2), as well as Xfce (stage 3). The GNOME port is submoduled at `stage3/gnome`, and any further desktop environments which become supported in the future will also be submoduled. The GNOME port is maintained at the [MassOS-GNOME](https://github.com/MassOS-Linux/MassOS-GNOME) repository. | ||
|
|
||
| [](https://discord.gg/EfshNrt) | ||
| This repo also does not contain the MassOS Installation Program found in the live CD, or the scripts used to build live ISO images for MassOS. Those can be found in the [livecd-installer](https://github.com/MassOS-Linux/livecd-installer) repository. | ||
|
|
||
| We may or may not set up a MassOS dedicated Discord server in the future. | ||
|
|
||
| You can also send an email to [daniel@massos.org](mailto:daniel@massos.org) for any queries/questions/suggestions/problems/etc. | ||
| # Bug Reporting | ||
| If you have found a bug in MassOS, please do the following before reporting it: | ||
|
|
||
| - Check that you are on the latest version of MassOS, by running `massos-release`. | ||
| - Check the [development branch](https://github.com/MassOS-Linux/MassOS/tree/development) to see if your issue has already been fixed for the next version of MassOS. | ||
|
|
||
| If you have checked both of these, and you believe this issue has not already been fixed in the development branch, then go to the [issues](https://github.com/MassOS-Linux/MassOS/issues) page and open an issue. Please describe your issue in detail, and provide any relevant logs and screenshots which could help us debug your issue. | ||
| # Contributing | ||
| You are welcome to fork the MassOS repository and make changes/additions as you wish. If you then want to contribute your changes back, you can do so by opening a [pull request](https://github.com/MassOS-Linux/MassOS/pulls). However, we ask that you follow these guidelines if you want to contribute your changes: | ||
|
|
||
| - Please only modify the **development** branch. If you've forked MassOS, you can switch the branch to **development** or set the main branch of your fork to the development branch, but either way, we will only accept changes to the development branch. | ||
| - Similarly, please only submit pull requests to the **development** branch. Pull requests will never be merged directly into the main branch. | ||
|
|
||
| If you make a significant contribution to MassOS, your name may be featured in the [Contributors List](contributors.md). | ||
| All repositories for the MassOS project can be found [here](https://github.com/orgs/MassOS-Linux/repositories). |
Oops, something went wrong.