Growing Plasma Mobile: Goal: Onboarding of new contributors
Open, HighPublic

Description

  1. Find out what the current process is.
  2. Write a walkthrough (or check if one already exists on the wiki) which will help aspiring contributors become active contributors.
  3. Work with the people of T7116 so we can keep up to date with the changes they introduce to the process so we can keep our tutorials, walkthroughs, etc. current.
paulb created this task.EditedJan 20 2018, 8:23 AM
paulb triaged this task as High priority.
paulb added a subscriber: skadinna.

@skadinna, you are the wiki-whisperer... Do you know if there is a document anywhere that explains how to become a full-fledged Plasma Mobile contributor? Or anything else we can use and adapt?

paulb reassigned this task from paulb to skadinna.Jan 20 2018, 8:30 AM

https://phabricator.kde.org/T584 <- is general Plasma developer guide.

lydia added a comment.Jan 20 2018, 4:21 PM

Before we start introducing more ways of getting people in board let's please consolidate and improve what we have. At the end there should be one place where people get started for contributing to KDE and then only additional guides to that that explain things relevant for the project in particular.

@lydia I've been pointing people to https://community.kde.org/Get_Involved, which is really good. We might consider centralizing information there and deprecating all of our other redundant points of entry.

It would be awesome if we could have a page like https://whatcanidoformozilla.org/#!/progornoprog/advocate
(even on wiki)

paulb added a comment.Jan 20 2018, 4:33 PM

Not especially thinking of new ways, @lydia , more along the lines @ngraham points out, that is, the best guide we can find so we can, if possible, improve it and point new potential contributors to it.

skadinna added a comment.EditedJan 20 2018, 4:55 PM

Apart from the developer guide that @bshah linked above, there's also this:

https://community.kde.org/Plasma/Mobile

and its subpages. Not sure how up-to-date all this information is, but there's a FAQ already set up (that could be easily expanded), as well as information on flashing devices and on contributing to Plasma Mobile.

It might be worth investing some time into updating all this.

As for the Get Involved page, we should definitely work on cleaning it up and turning it into the central information access point for all new contributors.
The first step could be to make it look less like a wall of text, and more like icons/images with short, actionable descriptions. (I'll try to make a sketch real quick and attach it here so you can see what I mean).

EDIT:
We should also think about the Plasma Mobile forums - do we want to direct potential contributors there (and in which cases/for which types of questions)?
Or do we highlight IRC channels/Matrix rooms as the main venues of communication with the developers?

paulb added a comment.Jan 20 2018, 6:33 PM

Apart from the developer guide that @bshah linked above, there's also this:

https://community.kde.org/Plasma/Mobile

and its subpages. Not sure how up-to-date all this informat

Thanks @skadinna.

Of all the subpages you mention, I think this one:

https://community.kde.org/Plasma/Mobile/Contributing

best fits the description if this task. It is very simple, to the point and straightforward. You land on it and can immediately know what to do.

All the the other suggested pages are valuable in their way, but this one would probably be the best first point of entry. Once new contributors know who to go to, more veteran users can direct them to more specific pages.

However, I am not sure the information is current. There is no mention of IRC/Telegram/Matrix channels, for example. and Plasma Mobile forums does not terribly active (there are big gaps between posts).

What do you guys think? And, if you agree, can we update it?

Yeah, that's a good one!
Forums are in a sad state, so as a way to contact, we'd better provide #plasmamobile:matrix.org and https://t.me/plasmamobile.

As for https://community.kde.org/Get_Involved, I think this would be a good step 2, but the text again needs some serious editing. The parts about Phabricator, for example, need cleaning up, taking out the section where the author mentions what it is built on and other irrelevant bits, and focusing on the features which will be immediately interesting for a newcomer. Also, illustrating with some images would help clarify things for people unfamiliar with the platform.

This page would also benefit of changing out links to forums for something more current.

I had a crack at re-organizing and rewriting parts of https://community.kde.org/Get_Involved to make it more approachable. What do you guys think?

First impression: That is MUCH better, @ngraham. It is late here, but I will look over it in depth tomorrow.

Has the list of supported devices for Plasma Mobile been updated lately? https://community.kde.org/Plasma/Mobile/FAQ only lists the LG Nexus 5 and LG Nexus 5X phones. I don't need another phone (sorry, dedicated iPhone user), but I'd be willing to shop for a compatible tablet if there are any that can run Plasma Mobile.

Has the list of supported devices for Plasma Mobile been updated lately? https://community.kde.org/Plasma/Mobile/FAQ only lists the LG Nexus 5 and LG Nexus 5X phones. I don't need another phone (sorry, dedicated iPhone user), but I'd be willing to shop for a compatible tablet if there are any that can run Plasma Mobile.

Following discussion with @bshah, we opted for eliminating this reference from project status and updated https://community.kde.org/Plasma/Mobile/FAQ#Can_I_run_Plasma_Mobile_on_my_mobile_device.3F clarifying the status about devices.

Do we need more work here or can we close this task? I see that plasma-mobile.org has this nice "What do you want to do?" questionnaire based on asknot, which should provide a decent onboarding experience.

bugsbane added a subscriber: bugsbane.EditedFri, Mar 22, 1:45 AM

Hi there. Sorry for the necro comment (just realized after posting!). I'm just currently trying to figure out how to contribute, and came across this, so I figure I'm in the target market (ie someone not currently contributing but looking to start). My background is in marketing/design/UX. I just wanted to share my personal experience with the current interaction path. I didn't manage to complete my desired goal, which was finding a good beginner task that would help Plasma Mobile, fit my skills and had someone who could help me get started.

Here's the path I took:

  1. Started at plasma-mobile.org as that was the official site of what I wanted to contribute to. There's a "contribute" button on the first fold! Awesome! I clicked for the first time.
  2. I get taken to... a page about social channels I can follow?! That's not what I was trying to get to! After a bit realized that there's a link in there offering tasks. It might be more obvious if I didn't have Plasma's night colors activated on my monitor. Either way it wasn't the first, second, or third thing my attention was drawn to on the page. It's far less prominent than the unrelated title "Community" and the icons for the various social channels. I'm not sure why I was directed to this page first. Anyway I click the link hoping to find the answer to my task on the third page and am met with...
  3. A wiki page? Uh... Is there anything obvious there that would lead me to finding a good starter task? Not that I can see. It says it's home of the documentation... which doesn't seem relevant. It says developers should go to a fourth website. I'm not a developer though, so not really relevant to me personally. Then it says that the main page is plasma-mobile.org, which I came from two sites ago. Then there's yet more links to go and join the community instead. And that's about it. I'm not sure where to go, so I click on the Plasma Mobile logo, hoping it might take me somewhere relevant, and I end up...
  4. Looking at an image of the plasma mobile logo, and nothing else. Not even a web page. This is pretty much the point I gave up. I've clicked across 4 sites/pages, didn't find what I needed to get started, and was left staring at a logo with nothing to interact with.

My suggestion would be to give potential contributors the absolute shortest possible path between clicking the "contribute" button and finding a quick, beginner task to start on, with a mentor to help. I wish the "Contribute" button on page 1 just went *directly* to a page that either lists open beginner tasks (including non coder tasks), or better yet the "What do you want to do?" questionnaire mentioned above that I couldn't even find.

Anyway, I really appreciate all the work and conversations here about helping people to get started. I would urge that the contributor interaction path be tested and modified with potential user cohorts before closing this ticket yet. Thank you!

PS. I'm still interested in helping with promo work specifically for Plasma Mobile, and I'm sure I'll find my way there eventually! I just wanted to share the experience of a new potential contributor with the current setup.