-
Notifications
You must be signed in to change notification settings - Fork 16
Guidelines
Tenshi Hinanawi edited this page Nov 23, 2012
·
1 revision
When creating a guide to be used in the Android Development Codex, please follow these guidelines:
- List all sources and give all credit where it is due. - Cite your methods, tools, and sources, if only to add some legitimacy. The developers on XDA worked hard to make these tools and guides. The least you could do is credit them for their work. That said;
- Don't link to a site or the forum for methods; Move everything to the wiki and give sources. - The XDA Wiki started up with similar goals, but was an utter failure. The reason the XDA Wiki fell flat is due to it's tendency to link to methods on the forum, rather than place them on the wiki. This made the wiki functionally redundant in practice, and a mess of links at best.
- Ensure that all needed files are in a safe place with multiple mirrors. - Link rot happens, and we have to be prepared.
- Always include a manual method for rooting/unlocking/recovery in addition to an easy, one-click method (if any). This ensures that there is something to go back to
- Don't create redundant material. Link to a similar page from this guidebook and add stuff there, or suck in a template page.
- Define all terms used in a Glossary prefacing the guide. Try to use and adapt the templates that already exist to the needs of the guide.
While this template is not set in stone, try not to deviate from it too far..
- Specifications - The tech specs at the right displaying all the gritty details of the device.
- Introduction - Give a brief summary of what this device is, how the modding community on it evolved, something that makes it special.
- Glossary - Stitch together some Glossary Templates so that newbies know what we are talking about.
- Requirements - All the files needed and steps that need to be done before proceeding.
- Rooting - Methods of gaining superuser privileges. Make sure to include the manual method.
- Unlocking the Bootloader (if any)
- Installing a Recovery Image
- Custom ROM Notes - Notes on what Android versions are available, which ROMs are good, whatnot.
- Device Specific Modifications - Mods that specific to this device.
- Credits and Sources - Give due credit to developers and record sources for information and guides.
Note: All non-Android projects have moved to the BASLQC Wiki.
- Introduction - A quick intro to the rationale and ideals of this guide, and smartphone modding in general.
- General Setup - Learn how to install and run the tools you need to succeed.
- Device Guides - Customized, fully decked out guides for rooting each and every device we could find.
- General OS Customizations - General customizations that work on all devices of a specific OS.
- General Guidelines - The ideals that you should uphold while working with and editing this guide.
- Device Guide Templates - Templates and general guidelines for creating customized guides for a device.
- Linux - Run a full desktop OS on your little mobile device; research is being made to make it comfortable to use in the mobile space.
- Glossary - Contains all the crazy acronyms and word soup that you'll need to wade through when using this guide.
- Android Buying Guide for Modders - While modding can fix up an outdated device, it will make your life easier to buy the right device from the start.