Skip to content

Commit

Permalink
docs: part 5
Browse files Browse the repository at this point in the history
  • Loading branch information
validcube committed Oct 21, 2023
1 parent d58fd96 commit 8a3d163
Show file tree
Hide file tree
Showing 8 changed files with 82 additions and 54 deletions.
6 changes: 3 additions & 3 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,13 +71,13 @@ If you encounter a bug while using the ReVanced Manager app, open an issue using
1. Fork the repository and create your branch from `dev`
2. Make sure that the commit name are clear and concise as possible and commit your changes.
If you have never contributed to this repository before, it's recommended to follow the rules in the [documentation](/docs/README.md)
If you have never contributed to this repository before, it's recommended to read the overview in the [documentation for developers](/docs/developers/README.md)
3. Open a pull request to the `dev` branch and reference issues that your pull request closes
4. The maintainers of ReVanced Manager will review and provide suggestions.
Once your pull request is approved and merged, it 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 help us by
translate the ReVanced Manager application at [Crowdin](https://translate.revanced.app/)!
translate the ReVanced Manager application at [Crowdin](https://translate.revanced.app/).

❀️ Thank you for considering contributing to ReVanced Manager
❀️ Thank you for considering contributing to ReVanced Manager.
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,8 +44,8 @@
</p>

# πŸ’Š ReVanced Manager
[![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-compose/commits/compose-dev)
[![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-compose/commits/compose-dev "")

## ❓ About
ReVanced Manager is an Android application that uses ReVanced Patcher to add, remove, and modify existing functionalities in Android applications.
Expand All @@ -64,7 +64,7 @@ You can obtain ReVanced Manager by downloading it from either [revanced.app/down
Anything else can be found here.

## πŸ“„ Documentation
Step on how to compile & use the application are available [here](/docs/README.md).
Step on how to use the application are available [here](/docs/README.md).

## πŸ‘‹ Contributing
You can find the contribution guidelines [here](/CONTRIBUTING.md), Thanks for consider contributing to ReVanced Manager!
Expand Down
6 changes: 0 additions & 6 deletions docs/3_troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,9 +23,3 @@ In case you encounter any issues while using ReVanced Manager, please refer to t
- 🚨 Patched app crashes on launch

Select the **Default** button when choosing patches.

## ⏭️ What's next

The next page will teach you how to build ReVanced Manager from source.

Continue: [πŸ”¨ Building from source](4_building.md)
38 changes: 0 additions & 38 deletions docs/4_building.md

This file was deleted.

7 changes: 3 additions & 4 deletions docs/README.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,7 @@
# πŸ’Š ReVanced Manager

This documentation explains how to use [ReVanced Manager](https://github.com/revanced/revanced-manager).

## πŸ“– Table of contents

0. [πŸ’Ό Prerequisites](0_prerequisites.md)
1. [⬇️ Installation](1_installation.md)
2. [πŸ› οΈ Usage](2_usage.md)
Expand All @@ -12,10 +10,11 @@ This documentation explains how to use [ReVanced Manager](https://github.com/rev
3. [πŸ”„ Updating ReVanced Manager](2_3_updating.md)
4. [βš™οΈ Configuring ReVanced Manager](2_4_settings.md)
3. [❔ Troubleshooting](3_troubleshooting.md)
4. [πŸ”¨ Building from source](4_building.md)

## ⏭️ Start here
## πŸ‘‹ Developer version
Are you a contributors? Consider checking out developer version of the [documentation](/developers/README.md).

## ⏭️ Start here
The next page will tell you about the prerequisites for using ReVanced Manager.

Continue: [πŸ’Ό Prerequisites](0_prerequisites.md)
24 changes: 24 additions & 0 deletions docs/developers/0_preparation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# πŸ’Ό Preparing a developer environment
In order to compile ReVanced Manager, certain requirements must be met.

## πŸ“ Prerequisites
* Kotlin IDE such as [Android Studio](https://developer.android.com/studio)
* Understanding of [Android](https://android.com) OS and [Kotlin](https://kotlinlang.org/) language
* At least Java Development Kit version 17 of any vendors

## πŸƒ Prepare the environment
1. Clone the repository
```sh
git clone https://github.com/ReVanced/revanced-manager.git && cd revanced-manager
```
<!-- This assume that you can use Maven repository -->
2. Build the APK
Release variant:
```sh
./gradlew assembleRelease -Psign
```

## ⏭️ What's next
The next page will introduce you to basic overview of ReVanced Manager

Continue: [πŸ’ Overview](1_overview.md)
38 changes: 38 additions & 0 deletions docs/developers/1_overview.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# πŸ’ Overview
Take a quick peak of how ReVanced Compose work.

## βš™οΈ Technology
We use [Jetpack Compose](https://developer.android.com/jetpack/compose) 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.

## 🌲 Structure
We structure our code to use MVVM (Model-View-ViewModel) architecture for easier maintenance of the code.

* **Model**: responsible for retrieving & storing data as well as performing calculations and other operations
* **View**: responsible for displaying the UI to the user, and send inputs to **ViewModel**
* **ViewModel**: responsible for receiving inputs from **View** and send it to **Model** then update the result

## πŸ§‘β€πŸ’» Code readability
In order to maintain readability of the code, It's highly recommend that you follow
https://developer.android.com/jetpack/compose/api-guidelines style guide in order to maintain
consistent readability through out the codebase.

## 🎨 Design language
We adopt the [Material Design 3](https://m3.material.io) as our design language to
bring friendly, intuitive and colourful UI to our application ensuring that the
app's user interface is consistent, customizable, accessible, and engaging for our users.

## πŸ“ƒ Commit message
At ReVanced, we follow the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0)
format for our commit message.

`type`(**optional: scope**): message

Example:
* `feat`: translation settings
* `fix`(**settings**): NullPointerException when exporting logs
* `refactor`: optimise sub-optimal code
* `perf`(**api**): reduces network latency
* `docs`(**developer**): concise wording
* `build`: bump version to v1.9.3
11 changes: 11 additions & 0 deletions docs/developers/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# πŸ’Š ReVanced Manager
This documentation explains how the [ReVanced Manager](https://github.com/ReVanced/revanced-manager) work.

## πŸ“– Table of contents
0. [πŸ’Ό Preparing a developer environment](0_preparation.md)
1. [πŸ’ Overview](1_overview.md)

## ⏭️ Start here
The next page will tell you how to prepare a environment for ReVanced Manager.

Continue: [πŸ’Ό Preparing a developer environment](0_preparation.md)

0 comments on commit 8a3d163

Please sign in to comment.