jewelfox: A portrait of a female anthropomorphic fox, with a pink jewelled pendant and a cute overbite. (Default)
[personal profile] jewelfox
In my last entry, I asked a few questions about the New GNOME User experience:
  1. A novice programmer learns to write GNOME apps. What does she do? Where does she go? When does she give up in frustration?

  2. A GNOME user notices an error in the documentation, or a bug in an application she uses. How does she correct it? How does she find out how to correct it? How far out of her way does she have to go to correct it once she finds out?

  3. A GNOME enthusiast wants to ask a question, or share something she's learned with her friends. Where does the conversation happen? What medium does it use? Whose needs was that medium designed to meet, when?
Let's look at a hypothetical scenario for that first question, to get an idea of the kinds of challenges new application developers face.

Goal: Learn to write apps

This hypothetical person knows what an app is, that people called "developers" write them, and that she can use her distro's package manager to get them. She may have dabbled in HTML, but she doesn't know how to program beyond that. It's only now that she's decided she wants to learn, because she wants to write an app for her favourite platform. She's not interested in "contributing to GNOME" beyond that ... yet.

  1. Start on gnome.org. Oh, hey, there's an "Applications" option right there. Let's click on it.

  2. It's talking about "the great applications that you can use on GNOME", but doesn't say how to make them. Maybe "Get Involved" says something about it?

  3. That talked about "contributing code," which sounds sort of like writing an app. It linked me to the GNOME Love page, but this is talking about mailing lists and patches and IRC and stuff. It says there are a few tutorials, but they're all years out of date. Oh wait, it says something about a "GNOME Developer Center". Is that what I want?

  4. It has a carousel of shiny "10-minute tutorials," which looks reassuring. The text underneath says I need to download developer tools to get started. But the page for that stumped me. I got the Software Centre to install Anjuta, DevHelp, and Glade like it said, but which is my "favourite programming language"? How do I know? Who's going to tell me which one is best or where I can learn it at?


If our newb is especially perspicacious, she may just pick one at random and go from there. Or she may do like I tend to do and spend hours reading comparisons between each language. Either way, she's hit a speed bump, if not a brick wall, and it took her awhile to figure out how to get here.

If she does click on one of the 10-minute tutorials? This is what she'll see, no matter which one she picks. Even if the carousel worked, the tutorials aren't sorted by programming language. She might've settled on Python, only to find herself faced with C.

Questions:
  1. Why doesn't the Applications page have a link to our Developer Centre? Outside of the one in the footer. Do we assume that nobody visiting gnome.org wants to learn to write GNOME applications, or that everyone who wants to already knows how?

  2. Why do we assume that newbs already have a "favourite programming language?" Are we wishy-washy about recommending one to beginners, or do we assume that there are no beginners consulting our Developer Centre?

  3. Why do our tutorials suggest installing Anjuta and Glade when they simply don't work with the latest GNOME technologies? JavaScript can't be debugged in Anjuta, and Glade doesn't support ApplicationWindows, IIRC.


I feel we could do a lot better here, and I'm open to suggestions for what I can do. Personally, I feel that the biggest change we can make beyond modernizing our tutorials would be a direct link to our Developer Centre from the Applications page. Even if someone didn't go there wanting to learn to write apps, we can put the thought in her head that "Yes, you can do this if you want to," and she'll be more likely to take a closer look.

Feel free to discuss in the comments! If you don't have an OpenID to leave a comment with, I can be reached @jewelfox on identi.ca.
From:
Anonymous( )Anonymous This account has disabled anonymous posting.
OpenID( )OpenID You can comment on this post while signed in with an account from many other sites, once you have confirmed your email address. Sign in using OpenID.
User (will be screened if not on Access List)
Account name:
Password:
If you don't have an account you can create one now.
Subject:
HTML doesn't work in the subject.

Message:

If you are unable to use this captcha for any reason, please contact us by email at support@dreamwidth.org


 
Links will be displayed as unclickable URLs to help prevent spam.

About us

~ Fox | Gem | Rei ~

We tell stories, paint minis, collect identity words, and share them all with our readers. If something we write helps you, let us know.

~ She / her ~

Tags

Style Credit

Page generated Oct. 17th, 2017 07:51 am
Powered by Dreamwidth Studios