Re: GnomeVFS to GVFS migration guide

[Shaun McCance <shaunm gnome org>]

On Tue, 2008-07-15 at 03:04 -0400, Karl Lattimer wrote:
> Hi all,
> 
> Googling around a bit I have been unable to locate a migration guide for
> switching from GnomeVFS to GVFS. If we are to make large changes to API,
> modules etc... then it is important that we include adequate documentation
> in our library. I think that in future any changes like this need to have
> guides added to http://library.gnome.org/devel/guides in order to prevent
> causing problems for developers. If there is a guide available then can
> somebody please add it to the library, if there isn't I would be much
> appreciative if someone could write one (unfortunately I'm too short on
> time) and publish it in the appropriate place.
> 
> I think at this point we should consider developing our documentation ready
> for 3.0 so developers have a place where they can get involved, learn about
> the changes and help ensure that developers continue to maintain their
> software in appropriate time with the GNOME releases.
> 
> Some suggested documentation;
> 
>  * Custom widget guides e.g. composite widgets, derived widgets, popup
> widgets like context menus and custom widgets from scratch
>  * Developing GtkBuilder compatible widgets
>  * Panel applet development guide
>  * Using dialogs and creating custom dialogs
>  * Adding printing support to your application
>  * Localising your application
>  * Creating a plugin system for your application
>  * Using GConf
>  * Various guides regarding keying into available data sources and useful
> services, e.g. EDS and GNOME Keyring
> 
> and of course...
> 
>  * The aforementioned GnomeVFS to GVFS migration guide
> 
> Other migration guides could be added although I can't think of any right
> now. 
> 
> 
> I have created this as a page on live;
> http://live.gnome.org/DocumentationProject/DeveloperDocs please feel free
> to edit and contribute to this page, provide links to documents already
> existing in the halls of the intertubes so we can accumulate any already
> existing documentation onto library.

These are all good suggestions, but note that we already
have a page on lgo for this:

http://live.gnome.org/DeveloperGuides

Please add your suggestions there, so we can track them
in one place.

--
Shaun