Skip to content

Commit 0de24be

Browse files
committed
2 parents 76ff8e8 + 54cc163 commit 0de24be

File tree

2 files changed

+93
-0
lines changed

2 files changed

+93
-0
lines changed

CONTRIBUTING.md

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
# Contributing to PyTermOS
2+
Thank you for your interest in contributing to PyTermOS! We welcome contributions from anyone and are grateful for every bit of assistance.
3+
4+
This document provides guidelines for contributing to PyTermOS. Following these guidelines helps to communicate that you respect the time of the developers managing and developing this open source project. In return, they should reciprocate that respect in addressing your issue, assessing changes, and helping you finalize your pull requests.
5+
6+
Getting Started
7+
Fork the Repository: Start by forking the PyTermOS repository on GitHub.
8+
Clone Your Fork: Clone your fork to your local machine so you can do your work.
9+
```bash
10+
git clone https://github.com/MarkPavlenko/PyTermOS.git
11+
cd PyTermOS
12+
```
13+
Create a New Branch: For each new feature or bug fix, create a new branch based on the main branch.
14+
```bash
15+
git checkout -b feature-branch-name
16+
```
17+
# Making Changes
18+
## Make Your Changes
19+
Add or change the code as necessary for your new feature or bug fix.
20+
## Follow the Code Style
21+
Ensure your code conforms to the existing style of the project to maintain consistency.
22+
## Write Meaningful Commit Messages
23+
Your commit messages should explain why and what your changes do.
24+
# Testing
25+
Test Your Changes: Before submitting your changes, make sure your changes do not break the existing functionality. Run any existing tests and add new ones if necessary.
26+
# Submitting Changes
27+
Push Your Changes: Push your changes to your fork on GitHub.
28+
29+
```bash
30+
git push origin feature-branch-name
31+
```
32+
## Submit a Pull Request
33+
Go to your fork on GitHub and click the "New pull request" button. Make sure you are requesting to pull from your branch to the main branch of the PyTermOS repository.
34+
# Code Review
35+
## Respond to Feedback
36+
If the maintainers have feedback or questions about your changes, please respond promptly and make any required updates.
37+
## Accept Criticism Gracefully
38+
Remember that the criticism from a review is about the code and not about you as a person.
39+
# Stay Involved
40+
Contributions go beyond pull requests and commits. You can really help by:
41+
42+
### Reporting bugs.
43+
### Suggesting new features.
44+
### Writing or improving documentation.
45+
### Helping others in the community.
46+
47+
### Thank you for your contributions!

README.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1 +1,47 @@
1+
# PyTermOS
2+
![image](https://github.com/MarkPavlenko/PyTermOS/assets/109904787/c3d32466-7f25-453b-81bb-b19caedba08b)
13

4+
PyTermOS is a lightweight, Linux-Based operating system designed specifically for educational purposes and older hardware, emphasizing minimalism and efficiency. It provides lot's of great everyday functions like Supercommands and other. Here, at PyTermOS you can see the power of Linux-Based operating systems.
5+
# Features
6+
## Lightweight Design
7+
8+
Optimized for performance on both modern and legacy hardware (Raspberry Pi Family).
9+
## Educational Tool
10+
Perfect for students and enthusiasts looking to delve into the workings of a Linux-based OS.
11+
## PyTerm CLI Interface.
12+
PyTerm CLI Interface is very easy to use. Especially for people who think bash is hard to learn.
13+
To see the commands, you can type ? or help in the PyTerm CLI Interface.
14+
To see the usage of the commands, please go to [PyTerm's official README file](https://github.com/MarkPavlenko/PyTerm/blob/main/README.md).
15+
## Community Driven
16+
Open to contributions and improvements. You can fork or download the .zip file to make changes.
17+
# Installation
18+
The installation is very easy and great for people the only start using Linux Distros.
19+
## Requirements
20+
A Raspberry Pi (Works on every version of RPi),
21+
22+
SD Card (minimum 8 GB recommended)
23+
and
24+
25+
Internet connection for initial setup and downloads.
26+
## Installation Guide
27+
Download the latest release of PyTermOS from the Releases page.
28+
### Write the image to an SD card
29+
Use a tool like RPi-Imager or Balena Etcher.
30+
Insert the SD card into your Raspberry Pi.
31+
### Boot your Raspberry Pi
32+
Connect your Raspberry Pi to power and a display.
33+
Wait until the system starts.
34+
# Usage
35+
After installing PyTermOS, you can interact with the system through the [PyTerm](markpavlenko.github.io/PyTerm) command line interface (PTCLI).
36+
## Starting the CLI
37+
Turn on your Raspberry Pi.
38+
Wait until the system starts.
39+
When the loading ends, you will be greeted by the [PyTerm](markpavlenko.github.io/PyTerm) command prompt.
40+
# Contributing
41+
We welcome contributions from the community! Whether it's bug fixes, feature additions, or improvements to documentation, your help is appreciated. Please read CONTRIBUTING.md for details on the process for submitting pull requests to me.
42+
# License
43+
PyTermOS is open source and freely available under the MIT License. See the LICENSE file for more details.
44+
# Releases page
45+
To see all the releases, please go to this [https://github.com/MarkPavlenko/PyTermOS/releases](https://github.com/MarkPavlenko/PyTermOS/releases) page.
46+
## Contact
47+
For support, feedback, or queries, please reach me out at markpavlenkos@icloud.com (main) or at markpavlenkos@gmail.com (trash).

0 commit comments

Comments
 (0)