Re: [gnome-flashback] Improving documentation

["Sebastian Geiger (Lanoxx)" <lanoxx gmx net>]

Hi,

I have merged my patches into master yesterday evening. The update 
covers all chapters of the documentation and contains some fixes for the 
API documentation itself. In particular I would like to mention the 
following points:

 * DBusAppletsMigration guide has been merged and updated for API 5.0
 * The section about installation and Panel Applet files has been 
improved and now also contains examples for the Autotools files 
(configure.ac and Makefile.am).
 * The concepts section hopefully explains better the concepts of 
applet types and factory ids and their relationship to panel applet files.

Also Alberts and I have been cleaning up the documentation build system, 
so it is less cluttered with files and easier to maintain.

We were also able to reactivate the panel-applet module on 
developer.gnome.org [1], so since today you can find the documentation 
from the last release 3.17.2, the patches from yesterday are not 
included yet and will appear there, after Alberts has made the next release.

I would like to repeat my call for help, so if anyone has time to proof 
read my changes and wants to suggest improvements for point out errors 
he or she is welcome to do so.

There are also still two points I want to improve:

 * 1. I want to add some guide for using Gtk Inspector with Gnome Panel 
(in particular to explain that one needs to use Ctrl+Alt+Tab to focus 
the panel before one can press Ctrl+Shift+i to open Gtk Inspector).
 * 2. Maybe write some more about the GSettings API and that the gconf 
related functions have been removed.

Cheers
Sebastian

[1] http://developer.gnome.org/panel-applet/

On 30/08/15 14:30, Lanoxx wrote:
> Hi everyone,
>
> I have been working on some patches to improve the Panel Library
> Reference Documentation in the doc folder of gnome-panel and the API
> documentation of libpanel-applet. The current work in progress can be
> found in the wip/segeiger/reference-documentation branch of gnome-panel.
>
> I would like to get some feedback and if there is anything you want to
> see better documented please let me know and I will see if I can include it.
>
> Additionally to whats already in this branch, I am planning to add the
> DBusAppletMigration [1] guide from the Gnome Wiki and add some notes for
> GConf to GSettings migration and libpanel-applet 5.0.
>
> Cheers
> Sebastian
>
> [1] https://wiki.gnome.org/Initiatives/GnomeGoals/AppletsDbusMigration