wordpress-mobile / wordpress-mobile/WordPress-Android

Onboarding Improvements

Open
#9,947 2 comments 0 reactions 2 assignees View on GitHub

@designsimply is already working on this.

Since Jun 2, 2020.

[Type] Enhancement Documentation
Dominant language
Kotlin
Stars
3.2k
Forks
1.4k
Avg merge
1d 11h
Merged PRs (30d)
69

Description

During WPYYC Contributor day, we noted a few hiccups in on boarding:

  1. It seem that an Oracle JDK isn't needed anymore – Android Studio bundles one. We should get rid of that requirement in our setup steps.

  2. We should note warnings that the user can expect to see, such as:

  • Google Login will fail (that's ok!)
  • Gradle may prompt you to update (don't do it – it'll break everything)

We should also note a couple of prerequisites:

  • Supported operating systems
    • macOS, Windows(?), Linux (?)
  • Required storage space to set up an Android dev environment (about 20 GB)
  • You won't be able to test if your environment is a VM

It would also be great to have a list of features that can't be worked on by non-A8C devs.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.