Skip to content

Commit bd25a93

Browse files
committed
aim: Proper init README containing requirements and how to apply
Signed-off-by: Albert I <kras@raphielgang.org>
1 parent 73745b5 commit bd25a93

File tree

2 files changed

+61
-2
lines changed

2 files changed

+61
-2
lines changed

README.md

Lines changed: 61 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,62 @@
1-
Template for xda
1+
# AIMROM
22

3-
AIM android 10 xda template
3+
If you're going to build AIMROM for your device, please head to [Getting Started](https://github.com/AIMROM/manifest/blob/10.0/README.mkdn#getting-started) section of our manifest. This README is intended for anyone interested to become a maintainer of AIMROM.
4+
5+
## Table of Contents
6+
7+
* [General Requirements](#general-requirements)
8+
* [Applying for Maintainership](#applying-for-maintainership)
9+
10+
## General Requirements
11+
12+
1. You **MUST** own the device. Blind and untested builds are not allowed. Exemptions are given for devices with little hardware derivations, as long as you still own the base device.
13+
2. You are applying to maintain your devices, *not to do some sort of buildbotting*. Please take that into consideration! You gain some, you lose some.
14+
3. Have done **AT LEAST** one working UNOFFICIAL build.
15+
4. All sources used to build the ROM **MUST BE** made public via [AIMROM-DEVICES](https://github.com/AIMROM-DEVICES) organisation, **MUST BE** buildable and **MUST** reproduce a similar working build. In addition, device sources published **MUST** have proper authorships and **MUST** have working `aim.dependencies`. This implies that you have a knowledge of Git as well and not just editing files using *GitHub file editor*.
16+
5. Maintainers are *expected* to know what they're doing and what issues to be resolved. Feel free to ask team members if you need help beyond your knowledge.
17+
6. Maintainers are **ONLY** allowed to include same amount of device-specific features as stock firmware, in order to keep consistency of user experiences between devices.
18+
7. Maintainers are **PROHIBITED** to include features that aren't licensed to ship with certain devices. This includes but not limited to Qualcomm aptX, aptX HD, aptX Low Latency (LL), aptX Adaptive, etc. exFAT are *exempted* from this prohibition since Microsoft has published specifications of the file system to encourage its use on open source communities.
19+
8. Kernels shipped with the ROM are *discouraged* to contain excess features that a little to no people will use. This includes but not limited to custom governors, custom I/O schedulers, custom hotplugs, kernel tweaks, etc., unless it's necessary to have the device to function properly.
20+
21+
**We also take into decision your attitude towards community you're maintaining the device on. We won't accept any maintainers with major attitude issues as we don't want to bring ourselves into trouble!**
22+
23+
## Applying for Maintainership
24+
Please fork [packages_apps_freedomhub](https://github.com/AIMROM/packages_apps_freedomhub) and make a Pull Request against `10.0` branch containing the following changes below existing entries (sample, please change accordingly):
25+
26+
* `res/values/maintainers.xml`:
27+
```
28+
+ <string name="device_goldfish">Android x86 emulator (goldfish)</string>
29+
+ <string name="goldfish_maintainer">John Doe (johndoe)</string>
30+
```
31+
32+
* `res/xml/maintainers.xml`:
33+
```
34+
+ <Preference
35+
+ android:title="@string/goldfish_maintainer"
36+
+ android:summary="@string/device_goldfish"
37+
+ android:icon="@drawable/ic_devs_phone" >
38+
+ <intent
39+
+ android:action="android.intent.action.VIEW"
40+
+ android:data="https://github.com/johndoe" />
41+
+ </Preference>
42+
```
43+
44+
If device(s) you're applying requires new vendor entry to be added:
45+
46+
* `res/values/maintainers.xml`:
47+
```
48+
+ <string name="android_devices_cat">Android</string>
49+
```
50+
51+
* `res/xml/maintainers.xml`:
52+
```
53+
+ <PreferenceCategory
54+
+ android:key="android_devices"
55+
+ android:title="@string/android_devices_cat" >
56+
+
57+
... (device list)
58+
+
59+
+ </PreferenceCategory>
60+
```
61+
62+
When creating Pull Request, please state which device you're applying as well as link to your repository (READ: yours, not LineageOS, not PixelExperience, not [insert 69 ROMs here]). Please follow the formatting given to make it easier for us to keep list clean.
File renamed without changes.

0 commit comments

Comments
 (0)