This site has been retired. For up to date information, see handbook.gnome.org or gitlab.gnome.org.


[Home] [TitleIndex] [WordIndex] 

/!\ This historical page is from 2007. This page is outdated, it is not up to date anymore and does not describe the current state.

This page is about the convertion of http://developer.gnome.org in a gateway to all the developer related subsites, targeted at either GNOME contributors or independent software developers and vendors (ISD/ISV).

Currently http://developer.gnome.org is unmaintained and outdated. Its function is being partially covered by http://live.gnome.org. dgo needs to be fully migrated and unplugged. GnomeWeb/Library (library.gnome.org) is being developed, and this subsite will assume some other dgo responsibilities. Still, a "Development" link is planned in the General bar common to all the GNOME subsites (see GnomeWeb/Navigation). dgo will be purely a gateway, probably with almost no content by itself.

This affects GnomeWeb/Library.

1. Requirements

  1. Introduce and link to the development subsites in a comprehensible way.
  2. Make sure valid dgo content is not lost during the process.
  3. No URL loss: old URLs point to the new ones.

Related GnomeWeb/UseCases:

Since DGO is a gateway most if not all the use cases are only vehiculated, they get solved in another subsite. We need to provide clear hints to these users so they know where to go next. Also, we need to refine which use cases will be mostly solved in wgo and therefore can be taken out of the current list.

2. Tasks

This is a proposal.

  1. Agree on a plan at gnome-web-list (ongoing)

  2. Announce this goal to all the projects with content at dgo.
  3. Fix a calendar for unpublishing the current dgo content.

  4. Update http://developer.gnome.org/index.html explaining the current situation and keeping only relevant links to secondary pages.

  5. robots.txt telling search engines not to index dgo pages
  6. All dgo pages with a header explaining the situation and linking to more information.
  7. Prepare the new dgo page(s)
  8. Make sure all relevant content has been migrated
  9. Set the appropriate redirects to new pages
  10. Make the change once the rest of subsites are ready
  11. Reopen the subsite to search engines and release.

3. Structure

To be defined. By default it's only one page, perhaps more if we find good reasons. It will depend on the use cases and the information for developers available at wgo. See also this draft.

4. Mockups

Not available yet. Probably based on GnomeWeb/LooknFeel

5. Content

Just starting to draw ideas here.

GnomeWeb/Navigation defines the subsites to be linked:

Since wgo will have basic information related to development, we need to link to the appropriate wgo pages as well. This will be helpful to newcomers falling in the dgo page by accident and finding the links to developer subsites too tough.

It would make sense to have a Get Involved promo pointing to wgo/GetInvolved or a more specific page. See this old bug.

6. Current Content Analysis

6.1. News

Completely outdated content. Last news entry is from 2004. I guess we don't need it anymore.

6.2. Release Planning

Links to ReleasePlanning. So, it's migrated.

6.3. GNOME Developer's Feature Article

The latest feature article is "Getting the Most Out of GNOME CVS". So, you can have an idea of how outdated this is. There are 7 feature articles in the archive. Move them to wiki or make them available on library.g.o?

6.4. Architecture

Most of the content of those pages overlap with the Overview of the GNOME Platform written by Shaun. Also, it's quite outdated. Making Shaun's guide available in library.g.o should be enough.

6.5. Documentation

This one has several subsections.

"GNOME Policies" only have the accounts policy which is in NewAccounts.

"Whitepapers" has three items: one article about Nautilus internals (which could be available in the wiki or library.g.o) and two (useless) links to libxml and libxslt respectively.

"Tutorials" is just a bunch of links to several tutoriais. This could be be simply moved to a wiki page. "Programming Guides" has a list of guides which could be available in library.g.o. Some of the articles are obsolete.

"API" is a list of links to API docs for GNOME platform libraries. This could be available in library.g.o.

"Standards" is a just a list of specs. Most of them are part of FreeDesktop.Org initiative now. No need to have it.

"FAQ" links to an incomplete/broken document. No need to have it.

"GTK+/Gnome Application Development" links to a webpage about Havoc's book. A link to the book could be added to some wiki page.

"Online Books" links to Havoc's book and another book called "Writing GNOME Applications" by John R. Sheets. Same applies here.

6.6. Development tools

"GNOME Bug Tracker" links to some basic links for bug triagers. This content is covered in the Bugsquad wikipages already. "Glade Builder" has links to glade page. "GNU Build Tools" has some basic links about autotools. "Scripts" is a list of small tools for daily tasks for developers. This could be in a wiki page too. "GNOME SVN" is updated but it could be in a wikipage as well. "Getting Involved" is quite incomplete and we already have something better in JoinGnome. "External Resources" is quite useless: just a bunch of links. "Projects" is a list to the webpages of our internal projects. We already have a good and more complete list of them in TeamWorkspaces.

6.7. Projects

Some important guides from those projects are still hosted in d.g.o. Move them to library.g.o?

7. Docs to be rescued

List URLs of documents at dgo that are updated and/or important and shouldn't be lost after the dgo disconnection.

8. Bugs

We need to review the dgo related bugs to make sure they are solved elsewhere and close them.

10. Comments

The comments about library.gnome.org have been moved to GnomeWeb/Library

2024-10-23 11:10