Developer Docs Tasks
Contents
The HowDoI series is intended to be updated by developers. It is being published to developer.gnome.org
developer.gnome.org
https://etherpad.gnome.org/p/developer-docs-planning
Action list for cleaning up developer.gnome.org content. Produced by DavidKing, EkaterinaGerasimova and AllanDay at the 2014 Developer Experience Hackfest.
Restructure the developer.gnome.org homepage
Kill https://developer.gnome.org/gnome-devel-demos/unstable/getting-ready
Update the list of guides on https://developer.gnome.org/guides
Change the name of https://developer.gnome.org/platform-overview/stable/ to "Application Development Overview"
Change the name of https://developer.gnome.org/Gnome3PortingGuide/ to "Port(ing) applications from GNOME 2 to GNOME 3"
Change the name of https://developer.gnome.org/accessibility-devel-guide/stable/ to "Develop Accessible Applications"
Remove https://developer.gnome.org/gnome-devel-demos/stable/
- Link to platform demos - THIS NEEDS RESOLVING. NEED TO FIGURE OUT A WAY TO HAVE A SINGLE LIST OF ALL GUIDES WITHOUT MAJOR SUBPAGES.
Remove https://developer.gnome.org/integration-guide/stable/ and add a redirect to new guide location. Rename to "Integrating your application with GNOME 3".
(done) Add a section for "C++ Development" (put this at the bottom of the page). Move the links to the "programming with gtkmm3", libsigc++ and libxml++ pages to this section.
Rename https://developer.gnome.org/ProxyConfiguration/ to "Picking up GNOME proxy settings" (should add something about libproxy to this page).
- Create an "Archive" section at the bottom and move The Clutter Cookbook and "Understanding Metacity Themes" there.
- Remove the "Tutorials" section heading.
- Move "GTK+ 2.0 Tutorial" to the Archive section.
- Move "GTK+ Programming Tutorial" to the Archive section.
- Remove the link to "GTK+ Frequently Asked Questions".
Remove https://developer.gnome.org/gnome-doc-make/unstable/intro.html.en. Add a link to the new Help Guide.
- Move the Documentation Style Guide to the Archive section.
- Move the XSLT page to the Archive section.
GNOME 3 Porting Guide
- Lives on the wiki
Accessibility Developers Guide
- Being ported to Mallard
- Need somebody to review and revise/rewrite
- May be mergable into the devel-guide after the rewrite
devtools-help
- Update Anjuta help (convert to mallard, write topic-based) - not high priority, lets see what time permits
- Check other devtools documentation (glade?)
Developer Demos
GOAL:
Tech (Tutorial) |
C |
C++ |
Java |
JS |
Vala |
Python |
1 GTK+ (image-viewer) |
draft |
draft |
|
draft |
review |
draft |
2 GStreamer (guitar-tuner) |
draft |
draft |
|
|
draft |
stub |
3 GStreamer (audio-player) |
|
|
|
|
stub |
|
4 GStreamer (magic-mirror) |
|
|
|
|
draft |
|
5 Clutter (photo-wall) |
draft |
|
|
|
|
|
6 DBA (record-collection) |
|
|
|
draft |
|
|
7 WebKitGTK+ (message-board) |
draft |
|
|
|
|
|
8 Cairo |
|
|
|
|
|
|
9 Telepathy |
|
|
|
|
|
|
10 Canberra |
|
|
|
|
|
|
11 Pulseaudio |
|
|
|
|
|
|
12 EDS |
|
|
|
|
|
|
Missing technologies:
GTK+ specific topics (GtkTreeView, GtkTextView, etc)
- ATK
- GIO
- DBus
- Telepathy
GDP Style Guide / Style Guide
Old style guide in gdp-style-guide. New on wiki: https://wiki.gnome.org/DocumentationProject/Guide/
HIG / HIG3
Old HIG in hig, new is on https://wiki.gnome.org/Design/HIG
Platform Overview
The platform-overview is intended to be a code-free overview of what is available for development using GNOME tools.
- Get started?
- Currently in platform-overview, maybe should be moved out
- Core technologies
- Overview of libraries based on what the aim is
- Details
- List of all libraries
- License "recommendations"
- Development tools
- Programming language support
- Cross-platform support
- GNOME integration
- Link to HIG