From 2fc099568e00a4e2b51c5f3c9e1c4c970a16a074 Mon Sep 17 00:00:00 2001 From: oSumAtrIX Date: Mon, 12 May 2025 18:30:00 +0200 Subject: [PATCH] docs: Add contribution guidelines and adjust README --- SECURITY.md => CONTRIBUTING.md | 48 +++++-- README.md | 119 ++++++++++++------ ...anced-logo-round.svg => revanced-logo.svg} | 0 3 files changed, 121 insertions(+), 46 deletions(-) rename SECURITY.md => CONTRIBUTING.md (58%) rename assets/revanced-logo/{revanced-logo-round.svg => revanced-logo.svg} (100%) diff --git a/SECURITY.md b/CONTRIBUTING.md similarity index 58% rename from SECURITY.md rename to CONTRIBUTING.md index 15e3660d..f2838ff8 100644 --- a/SECURITY.md +++ b/CONTRIBUTING.md @@ -58,20 +58,46 @@ Continuing the legacy of Vanced

-# 🔒 Security Policy +# 👋 Contribution guidelines -This document describes how to report security vulnerabilities for ReVanced Manager. +This document describes how to contribute to ReVanced Manager. -## 🚨 Reporting a Vulnerability +## 📖 Resources to help you get started -Please open an issue in our [advisory tracker](https://github.com/ReVanced/revanced-manager/security/advisories/new) or reach out privately to us on [Discord](https://discord.gg/revanced). +* The [documentation](/docs/README.md) provides steps to build ReVanced Manager from source +* Our [backlog](https://github.com/orgs/ReVanced/projects/12) is where we keep track of what we're working on +* [Issues](https://github.com/ReVanced/revanced-manager/issues) are where we keep track of bugs and feature requests -If a vulnerability is confirmed and accepted, you can join our [Discord](https://discord.gg/revanced) server to receive a special contributor role. +## 🙏 Submitting a feature request -### ⏳ Supported Versions +Features can be requested by opening an issue using the +[Feature request issue template](https://github.com/ReVanced/revanced-manager/issues/new?assignees=&labels=Feature+request&projects=&template=feature_request.yml&title=feat%3A+). -| Version | Branch | Supported | -| --------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------ | -| ![Latest stable release](https://img.shields.io/github/v/release/ReVanced/revanced-manager?style=for-the-badge "Latest stable release") | main | :white_check_mark: | -| ![Latest version](https://img.shields.io/badge/version-latest-brightgreen?style=for-the-badge "Latest version") | dev | :white_check_mark: | -| ![Latest version](https://img.shields.io/badge/version-latest-brightgreen?style=for-the-badge "Latest version") | compose-dev | :white_check_mark: | +> **Note** +> Requests can be accepted or rejected at the discretion of maintainers of ReVanced Manager. +> Good motivation has to be provided for a request to be accepted. + +## 🐞 Submitting a bug report + +If you encounter a bug while using ReVanced Manager, open an issue using the +[Bug report issue template](https://github.com/ReVanced/revanced-manager/issues/new?assignees=&labels=Bug+report&projects=&template=bug_report.yml&title=bug%3A+). + +## 📝 How to contribute + +1. Before contributing, it is recommended to open an issue to discuss your change + with the maintainers of ReVanced Manager. This will help you determine whether your change is acceptable + and whether it is worth your time to implement it +2. Development happens on the `dev` branch. Fork the repository and create your branch from `dev` +3. Commit your changes +4. Submit a pull request to the `dev` branch of the repository and reference issues + that your pull request closes in the description of your pull request +5. Our team will review your pull request and provide feedback. Once your pull request is approved, + it will be merged into the `dev` branch and will be included in the next release of ReVanced Manager + +## 🤚 I want to contribute but don't know how to code + +Even if you don't know how to code, you can still contribute by +translating ReVanced Manager on [Crowdin](https://translate.revanced.app/). + +❤️ Thank you for considering contributing to ReVanced Manager, +ReVanced diff --git a/README.md b/README.md index c742bcab..91e70d8c 100644 --- a/README.md +++ b/README.md @@ -1,55 +1,104 @@ -# ReVanced Manager (Compose Rewrite) +

+ + + + +
+ + + + + +     + + + + + +     + + + + + +     + + + + + +     + + + + + +     + + + + + +     + + + + + + +
+
+ Continuing the legacy of Vanced +

-[![GitHub license](https://img.shields.io/github/license/revanced/revanced-manager)](../../blob/main/LICENSE) -[![GitHub last commit](https://img.shields.io/github/last-commit/revanced/revanced-manager/compose-dev)](https://github.com/ReVanced/revanced-manager/commits/compose-dev) -[![GitHub commit activity](https://img.shields.io/github/commit-activity/w/revanced/revanced-manager/compose-dev)](https://github.com/ReVanced/revanced-manager/commits/compose-dev) +# 💊 ReVanced Manager -_(Yet another)_ rewrite of the ReVanced Manager using Kotlin and Jetpack Compose. +![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/ReVanced/revanced-manager/release.yml) +![GPLv3 License](https://img.shields.io/badge/License-GPL%20v3-yellow.svg) -## Design system +Application to use ReVanced on Android -In this rewrite, we are adopting the latest Material Design principles and guidelines by using Material 3 and Material You. +## ❓ About -Material Design is a design system developed by Google that provides a unified visual language for building beautiful and consistent user interfaces across all platforms and devices. Material You is an extension of Material Design that provides even more customization options for users, making it possible for them to personalize their device and create a unique look and feel. +ReVanced Manager is an application that uses [ReVanced Patcher](https://github.com/revanced/revanced-patcher) to patch Android apps. -### Why Material 3? +## 💪 Features -* **Consistent design language** -* **Improved accessibility** -* **Better user experience** +Some of the features ReVanced Manager provides are: -By using Material 3 and Material You, we are ensuring that the app's user interface is consistent, customizable, accessible, and engaging for our users. This will help to improve the overall user experience and increase user satisfaction with the the manager. - -## Technology stack - -* Kotlin: Kotlin is a modern and concise programming language that is fully interoperable with Java and provides improved safety, readability, and maintainability compared to Java. -* Jetpack Compose: Jetpack Compose is a modern UI toolkit for Android development that allows developers to build beautiful and performant user interfaces using declarative programming. It provides a unified and efficient way of building UI that is well-integrated with the Android framework. - -## Why Kotlin and Compose? - -* **Improved safety:** Kotlin provides improved safety compared to Java, which reduces the likelihood of common programming mistakes that can cause security vulnerabilities or crashes. -* **Concise and readable code:** Kotlin's concise syntax and expressive type system make the code more readable, which makes it easier for developers to understand and maintain the codebase. -* **Better performance:** Jetpack Compose uses the power of the Android framework to provide smooth and fast performance, which enhances the user experience. -* **Modern and efficient UI development:** Jetpack Compose provides a modern and efficient way of building UI, which makes it easier for developers to create beautiful and performant user interfaces. +- ⬇️ **Download**: Automatically download apps using the ReVanced Manager downloader plugin system +- 💉 **Patch**: Select and apply patches to any Android app +- 🛠️ **Customize**: Manage patches, apps, signing, themes, updates, and many more settings ## 🔽 Download -You can obtain ReVanced Manager by downloading it from either [revanced.app/download](https://revanced.app/download) or [GitHub Releases](https://github.com/ReVanced/revanced-manager/releases) +You can download the most recent version of ReVanced Manager at [revanced.app/download](https://revanced.app/download) or from [GitHub releases](https://github.com/ReVanced/revanced-manager/releases/latest). +Learn how to use ReVanced Manager by following the [documentation](/docs). -## 📝 Prerequisites +## 📚 Everything else -For a list of prerequisites, refer to [docs/0_prerequisites.md](docs/0_prerequisites.md) +### 📙 Contributing -## 🔴 Issues +Thank you for considering contributing to ReVanced Manager. +You can find the contribution guidelines [here](CONTRIBUTING.md). -For suggestions and bug reports, open an issue [here](https://github.com/revanced/revanced-manager/issues/new/choose). +### 🛠️ Building -## 🌐 Translation +To build a ReVanced Manager, you can follow the [documentation](/docs). -[![Crowdin](https://badges.crowdin.net/revanced/localized.svg)](https://crowdin.com/project/revanced) +### 📄 Documentation -We're accepting translations on [Crowdin](https://translate.revanced.app) +You can find the documentation for ReVanced Manager [here](/docs). -## 🛠️ Building Manager from source +## ⚖️ License -For instructions on how to build ReVanced Manager from source, refer to [docs/4_building.md](docs/4_building.md) \ No newline at end of file +ReVanced Manager is licensed under the GPLv3 license. Please see the [license file](LICENSE) for more information. +[tl;dr](https://www.tldrlegal.com/license/gnu-general-public-license-v3-gpl-3) you may copy, distribute and modify ReVanced Manager as long as you track changes/dates in source files. +Any modifications to ReVanced Manager must also be made available under the GPL, along with build & install instructions. diff --git a/assets/revanced-logo/revanced-logo-round.svg b/assets/revanced-logo/revanced-logo.svg similarity index 100% rename from assets/revanced-logo/revanced-logo-round.svg rename to assets/revanced-logo/revanced-logo.svg