Guides

The old introduction covered too many topics for a single page. In the docs site, those topics work better as a small set of practical guides grouped by task and area.

In this section

• Application structure for organizing modules, UI files, resources, and app startup.
• Constructors and namespaces for the core object-model conventions.
• Properties for defining and using GObject properties.
• Signals for connection patterns, conflicts, and Python-defined signals.
• Subclassing for Python-defined GObject types, vfunc overrides, and automatic type naming.
• Async support for the async-first I/O model and event-loop integration shape.
• Gio for files, settings, actions, cancellation, and D-Bus.
• Pango for font, layout, and text-structure patterns.
• Gdk for value types, formats, and event-facing conveniences.
• Gtk for templates, CSS, expressions, and text/widget patterns.
• Type checking for stubs, stub generation, and mypy plugin integration.
• Concurrency for async behavior, event loops, and free-threading expectations.
• Migration from PyGObject for compatibility mode and selective adoption of native ginext APIs.

Readers looking for runtime speed and profiling guidance should start with the top-level Performance page.

The goal is to keep Guides small enough to scan while still giving each topic enough room to be useful.