vala-lang/vala-docs

feat: Create “A Tour of Vala” top-level page

Open

#244 opened on Jun 9, 2026

View on GitHub
 (0 comments) (0 reactions) (0 assignees) (28 forks)auto 404
documentationenhancementhelp wanted

Repository metrics

Stars
 (18 stars)
PR merge metrics
 (PR metrics pending)

Description

Description

It will be a guided introduction, where the reader will see the overview of what the language.

Like a bite-sized version of the tutorial only taking time to explain unique concepts in the language with a bit more detail.

For example, everything from: Variables, foreach loops, arrays that you can append to, functions, classes, methods, signals, lambdas, async will all be covered.

However signals will be covered with more detailed instead of being briefly introduced.

Possible Solutions

The Swift Tour is a good resource to get some inspiration from: https://docs.swift.org/swift-book/documentation/the-swift-programming-language/guidedtour

Additional Info

No response

Contributor guide

Research direction
Use the Swift Tour as a reference to structure the Vala Tour. Cover key language features with detailed explanations for unique concepts like signals.
Tech stack
None
Domain
documentation
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-2 days
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
Vala
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
75