GitLab

This issue tracks the short-term and long-term content plan for the GNOME Developer Center. The content plan is initially based on the Developer Center Whiteboard Design by @aday.

Note: Primarily this consists of notes by me for now, will need review.

Base Structure

The base structure consists of elements which are be accessible from the front page.

• "Get Started" (Key Item)
• API Reference (Core Item)
• Design Guidelines (Core Item)
• Tutorials (Core Item)
• Distribute (Core Item)
• Technologies Overview (Secondary)
• Get Involved in GNOME (Secondary)
• GNOME Development Guides (Secondary)

Get Started

The guide explains how to get started developing apps in GNOME.

Short-term plan:

• This guide will need writing. Maybe Getting Started with GTK+ would be a good inspiration?

Long-term plan:

• Perhaps, to have a dedicated maintainer of this guide?

API Reference

Shows a view of essential libraries and platforms, divided into topics.

Short-term plan:

• Generate documentation where possible. Fx with Hotdoc, libraries ported to HotDoc would shows nicely integrated documentation.
• Hardlink to gtk-doc documentation in places where libraries are not ported.
• External link to external projects' API reference where relevant.

Long-term plan:

• All generated documentation integrates with the documentation system.
• External links. I guess we still have to link to the external references. But maybe we can integrate them in our Search system and get notifications if the links die.

Design Guidelines

Short-term plan:

• Port over the HIG from Mallard.

Long-term plan:

• Maintain the HIG in markdown format.

Tutorials

Tutorials only focused on application development.

Short-term plan:

• Review and select HOWDOI tutorials to port over which are still relevant from the wiki.

Long-term plan:

• Create Redirects to the new tutorials.
• Have sections with various topics fx:
• Playground: Tutorials for beginners.
• Multimedia: ..
• Online Integration: ..

Distribute

This is essentially information Flatpak developer documentation and other information which falls into Distribution category (GNOME Release Schemes, Versioning, AppData?)

Short-term plan:

• External link to the Flatpak developer documentation

Long-term plan:

• Migrate Flatpak developer documentation to GNOME Developer Center? Although Flatpak is not a GNOME project.
• Maybe we can somehow integrate it anyway even if it is external? Through Search, cross-reference etc.

Technologies Overview

This is an overview of the technologies GNOME encompasses and builds upon.

Short-term plan:

• Link to https://www.gnome.org/technologies/

Long-term plan:

• Move https://www.gnome.org/technologies/ into the Developer Center? Or continue linking https://www.gnome.org/technologies/

Get Involved

Short-term plan:

• Links to the Newcomer Coding Guide https://wiki.gnome.org/Newcomers/

Long-term plan:

• Migrate the newcomer guide to the Developer Center.

GNOME Development Guides

This seems to overlap with the purpose of "Tutorials" to me. Maybe we can have "Contribute to Developer Docs / Migrate to Developer Docs?" here instead or something else?