Terms, variables

lib/Language/syntax.pod

@@ -146,15 +146,29 @@ is an error,
 assigns the return value of the if statement (here C<42>) to the variable
 C<$x>.
 
-=begin comment
 
 =head1 Terms
 
-TODO
+Terms are the basic nouns that, optionally together with operators, can form
+expressions. Examples for terms are variables (C<$x>), barewords such as type
+names (C<Int>), literals (C<42>), declarations (C<sub f() { }>) and calls
+(C<f()>).
+
 
 =head2 Variables
 
-TODO
+Variables typically start with a special character called the I<sigil>, and
+are followed by an identifier. Variables must be declared before you can use
+them.
+
+    # declaration:
+    my $number = 21;
+    # usage:
+    say $number * 2;
+
+See the L<documentation on variables|/language/variables> for more details.
+
+=begin comment
 
 =head2 Barewords (Constants, Type Names)