GNOME3 – for the developers
7. April 2011
Together with the release of GNOME 3 the new GNOME developer center was launched today. This is just the first step to make GNOME 3 a great developer platform but I hope it is already a big step!
There is still a bunch of things missing, like proper API documentation for languages using introspection (Javascript, Python) but things got a lot better with the new platform overview and will certainly improve in the future.
I have to especially thank Fréderic Peters who did all the dirty backend work on the infrastructure in the last days & weeks so everything could be launched on time.
However, this wouldn’t have been possible without many amazing people (in no particular order): Andreas Nilson, Julie Pichon, Phil Bull, Shaun McCance, Daniel g. Siegel, Patricia Santana Cruz, Ekaterina Gerasimova, David King, Jon Nordby, Chris Kühl, Jonh Wendell, Andre Klapper, Germán Poo and P. F. Chimento, hoping I didn’t forget anyone. And of course the beautiful cities of Berlin and Toronto!
Thanks!
7. April 2011 at 13:12
> proper API documentation for languages using introspection
Maybe MSDN docs can serve as good example here. They permit display of API and examples in the prefered .NET languages. So maybe the generated gtk-docs could get CSS and JavaScript voodoo to display signatures and examples in prefered language? Not sure how well this would work, or if there still independent docs are needed for explaing language specific syntatical suggar. but then this language specific notes also could just be shown as box.
++————————————
|| Python: Do it snake style…
|| ….
++————————————
hope you get the idea. one document explains many programming languages. so only one place to maintain documentation. one place to raise awareness of c hackers of gir language issues…
7. April 2011 at 13:45
Well, I think this is the idea and as introspection relies on gtk-doc anyway it should be doable someone. The vala guys also have valadoc which seems to do something like this. However, the Vodoo is simply missing at the moment and we should probably consolidate our JavaScript engines first.
7. April 2011 at 13:14
content of the new dev pages is awesome, btw. love how examples and tutorials are presented.
7. April 2011 at 16:39
Please do something about visuals. Pages like these are simply horrid:
http://developer.gnome.org/gtk3/stable/
http://developer.gnome.org/gio/stable/
http://developer.gnome.org/gdk/stable/
And a TOC at the start of ones like these would help lots:
http://developer.gnome.org/gtk3/stable/gtk-getting-started.html
http://developer.gnome.org/gnome-devel-demos/stable/image-viewer.c.html
The style of telepathy developer’s manual is much better:
http://telepathy.freedesktop.org/doc/book/index.html
7. April 2011 at 16:52
These aren’t technically part of developer.gnome.org but of the corresponding libraries. If you don’t like the stylesheet used on library.gnome.org, report a bug against library-web, if you think the content of library documentation is wrong, report it against the library. Thanks.
7. April 2011 at 17:07
A really nice improvement :), it’d be great to have some popups in the platform overview so newcomers find out at a glance what’s each library for.