beginning development & documentation barriers
TRANSCRIPT
![Page 1: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/1.jpg)
By Natan Yellin
Reducing DevelopmentBarriers
![Page 2: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/2.jpg)
How Do Normal UsersBegin Developing?
![Page 3: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/3.jpg)
Case Study: Mac OS X
![Page 4: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/4.jpg)
Step 1: Apple.com
![Page 5: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/5.jpg)
Step 2: Findhidden links
![Page 6: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/6.jpg)
Step 3: Find development links
![Page 7: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/7.jpg)
Step 4: Overview page
![Page 8: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/8.jpg)
Summary
Covers everything developers need to know: Programming languages Toolkits
Includes all necessary resources: Tutorials API reference IDE installation
4 clicks only
![Page 9: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/9.jpg)
Case Study: Ubuntu Linux
![Page 10: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/10.jpg)
“Linux For Humans”
![Page 11: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/11.jpg)
Step 1: Ubuntu.com
![Page 12: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/12.jpg)
![Page 13: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/13.jpg)
Just Kidding
![Page 14: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/14.jpg)
This page doesn't actually tell youanything
![Page 15: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/15.jpg)
Step 2: Find the link to theDeveloper Zone
![Page 16: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/16.jpg)
Step 3: Oh, this helps!
![Page 17: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/17.jpg)
![Page 18: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/18.jpg)
Huh?
![Page 19: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/19.jpg)
Step 4: Wait a minute...
![Page 20: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/20.jpg)
Step 4: Wait a minute...
Is “Packaging” a synonym for “Programming?”
![Page 21: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/21.jpg)
![Page 22: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/22.jpg)
Umm...
![Page 23: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/23.jpg)
Umm...
![Page 24: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/24.jpg)
This isn't about programming!
![Page 25: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/25.jpg)
200 Page Views Later....
![Page 26: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/26.jpg)
We're not even counting the steps any more...
![Page 27: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/27.jpg)
**Sigh
![Page 28: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/28.jpg)
Woohoo! An up-to-datedeveloper page
![Page 29: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/29.jpg)
A Closer Look
![Page 30: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/30.jpg)
“Last Modified 2006”
![Page 31: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/31.jpg)
Let's try this anyway...
![Page 32: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/32.jpg)
Close up:This looks nice
![Page 33: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/33.jpg)
At last?
![Page 34: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/34.jpg)
![Page 35: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/35.jpg)
![Page 36: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/36.jpg)
?
![Page 37: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/37.jpg)
Backtracking
![Page 38: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/38.jpg)
How are usersintroduced to
development tools?
![Page 39: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/39.jpg)
![Page 40: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/40.jpg)
A Closer Look
![Page 41: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/41.jpg)
Oops...1
![Page 42: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/42.jpg)
“Last modified 2003”1
![Page 43: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/43.jpg)
“GNOME Bug Tracker”2
![Page 44: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/44.jpg)
“GNOME Bug Tracker”Why is this the first item?
2
![Page 45: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/45.jpg)
“GNU Build Tools”3
![Page 46: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/46.jpg)
“GNU Build Tools”Uh oh...
3
![Page 47: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/47.jpg)
“GNU Build Tools”The Page of No Return
3
![Page 48: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/48.jpg)
Moving on
![Page 49: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/49.jpg)
http://live.gnome.org/GnomeLove
![Page 50: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/50.jpg)
This page (surprisingly) is useful
http://live.gnome.org/GnomeLove
![Page 51: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/51.jpg)
It can only be found by clicking onevery link on gnome.org
http://live.gnome.org/GnomeLove
![Page 52: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/52.jpg)
Most of it's useful content hasn't been updated in years.
http://live.gnome.org/GnomeLove
![Page 53: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/53.jpg)
Another Example
![Page 54: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/54.jpg)
![Page 55: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/55.jpg)
This one is impossible to findwithout Google
![Page 56: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/56.jpg)
These are useful, but only if you already know something about
programming
![Page 57: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/57.jpg)
On the other hand...
![Page 58: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/58.jpg)
“Oh! So this must bewhere I install an IDE”
![Page 59: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/59.jpg)
![Page 60: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/60.jpg)
?
![Page 61: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/61.jpg)
Never mind...
![Page 62: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/62.jpg)
Another case study
![Page 63: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/63.jpg)
Fedora Linux
![Page 64: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/64.jpg)
Step 1: FedoraProject.org
![Page 65: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/65.jpg)
Step 2: “Join Fedora”
![Page 66: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/66.jpg)
Step 2: “Join Fedora”
![Page 67: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/67.jpg)
Content Writer Designer
People Person
OS Developer
Translator
Web Developer or Administrator
![Page 68: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/68.jpg)
Where is App Developer?
Content Writer Designer
People Person
OS Developer
Translator
Web Developer or Administrator
![Page 69: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/69.jpg)
Let's try OS Developer
Content Writer Designer
People Person
OS Developer
Translator
Web Developer or Administrator
![Page 70: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/70.jpg)
![Page 71: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/71.jpg)
“Design & build OS... develop new features”
That sounds like what I'm interested in...
![Page 72: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/72.jpg)
Wait a minute... Why is there no actualinformation on getting started?
![Page 73: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/73.jpg)
Like with Ubuntu, the Fedora development pages don't even link to GNOME's documentation pages.
They assume that new developers with no experience will know where to go by themselves.
Even if developers do find GNOME's website,all the issues mentioned earlier apply.
![Page 74: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/74.jpg)
![Page 75: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/75.jpg)
Summary
![Page 76: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/76.jpg)
Fedora
Three websites and no good documentation...
![Page 77: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/77.jpg)
There's no central location for documentation some docs are found on distributions websites and some on project websites. Users don't know where to look.
Most of the existing documentation (excluding API reference) isn't up to date.
There are very few tutorials for helping people with no coding experience write their first program.
The current documentation isn't geared towards newcomers.
![Page 78: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/78.jpg)
![Page 79: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/79.jpg)
It doesn't have to be this way.
![Page 80: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/80.jpg)
Proposal: One Developer Resource
Create one central developer website. This can be hosted at Freedesktop.org. Clicking on ubuntu.com's “Get Developing” button
should take you to the Freedesktop developer website. There still will be a page to learn about packaging on the
Freedesktop website. Now, more people will be able to use that page after they learn to write their first program.
The website should be a wiki to allow anyone to update tutorials and documentation.
![Page 81: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/81.jpg)
Making this happen.1.We need to setup a wiki at develop.freedesktop.org.
2.We need distributions to support the effort and add their own documentation to the wiki.
3.When the wiki is in a usable state, we can request that the distributions work with us to make it fit in transparently with their own sites and brands.● E.g. If the user came from FedoraProject.org we can
show them the Fedora logo at the top of each wiki page along with a link back to FedoraProject.org.
● We can also show Ubuntu users their allimportant guide to packaging at every corner.
![Page 82: Beginning Development & Documentation Barriers](https://reader035.vdocuments.us/reader035/viewer/2022081403/5558e374d8b42ad7138b4de7/html5/thumbnails/82.jpg)
Thank you for listening.