Vala Documentation Updates - September 2026

Intro ​

Since the June update, the documentation website has gone through a big reorganisation and the Compiler Guide has grown a lot, with several new sections explaining how the Vala compiler actually works under the hood.

Here's what's new:

What's New ​

Changes ​

• Reorganised the site's directory structure to use fewer directory levels and be faster to navigate
  • Global navigation links are now used to navigate between top-level sections
  • Removed redundant index pages to improve nesting
  • Merged top-level sections together, like the Compiler Guide and Contributor Guide, into a single top-level Guides section
  • Sidebar content is now dependent on the current top-level section
  • Subsections with multiple pages now use their own separate sidebars
• Replaced the About page with a link to the About page on the main Vala programming language website
• Big expansion of the Compiler Guide:
  • Updated the Semantic Analyzer page with up-to-date information, covering what the Semantic Analyzer does, its key classes, how built-in symbol types are looked up, how the symbol tree is analysed, and error handling
  • Added a Flow Analyzer page explaining how the compiler's flow analysis works
  • Added a C Code Generation page with initial info on the C code generation process
  • Added a C Code Compilation and Linking page
  • Updated the Project Information page with up-to-date information
  • Added detailed info on how tests work in the compiler repo
  • Expanded on how vapigen works
  • Added info on debugging in the compiler repo using GNU Autotools
  • Added info on configuring an isolated install prefix in the Build System page
  • Rewrote the Vala Attributes processing info
  • Added section numbering to page titles throughout the guide, to make it easier to reference specific sections
• Added info about the valadoc --doclet option to the Valadoc Guide
• The Contributor Guide now appears before the Compiler Guide in the sidebar
• Added mailing list archive links to the External Resources section
• Added a link to the awesome-vala repo to the home page

Fixes ​

• Grammar and typo fixes:
  • #248 - Fixed "Lanugage" typo in the sidebar
  • #270 - Fixed a typo in the Contributor Guide

Closing Statements ​

Feel free to share your thoughts on this post in community spaces and social media.

The repository for the documentation website is located at: https://github.com/vala-lang/vala-docs. Feel free to report issues and help update the documentation.

Also, at the bottom of every page of the documentation site, there's an "edit this page" link, which makes it easy to fiz fix any typos that you find on a page you were reading.

Thanks for reading!