Docfix

Author: bzick

docs/api.md

@@ -712,7 +712,7 @@ Add or change month and day of the week localizations.
 
 **Month localization** 
 
-For parser (required utf8 module)
+For parser ([required utf8 module](#configure-utf8))
 ```lua
 local months = require("aspect.config").date.months
 months["дек"] = 12          -- add short name of december on russian
@@ -721,7 +721,7 @@ months["dic"] = 12          -- add short name of december on spain
 months["diciembre"] = 12    -- add long name of december on spain
 -- ...
 ```
-For formatter
+For formatter (utf8 module NOT required)
 ```lua
 local months_locale = require("aspect.config").date.months_locale
 months_locale["ru"] = {        -- add Russian name of month 
@@ -731,11 +731,11 @@ months_locale["ru"] = {        -- add Russian name of month
     --- ...
 }
 ```
-There 1 - january, 12 - december. Index 1 — short name of month, index 2 - normal name of month.
+There 1 - january, 12 - december. Index 1 — short name of month, index 2 - full name of month.
 
 **Week localization**
 
-For formatter
+For formatter (utf8 module NOT required)
 ```lua
 local week_locale = require("aspect.config").date.week_locale
 week_locale["ru"] = {  -- add Russian day of the week
@@ -791,6 +791,15 @@ How parsers work:
 
 See `date.parsers` for more information.
 
+### Date format aliases
+
+Add symbol `R` (`%R`) witch is `%I:%M:%S %p`
+
+```lua
+local aliases = require("aspect.config").date.aliases
+aliases["R"] = "%I:%M:%S %p"
+```
+
 Iterator and countable objects
 -------------------------------
 

docs/filters/date.md

@@ -26,16 +26,16 @@ Time must be supplied if date is not given, vice versa.
 If the 24-hour clock is used, it is an error to specify "PM" for times later than 12 noon. 
 For example, "23:15 PM" is an error.
 
-**Time Zone Format.**  First character is a sign "+" (east of UTC) or "-" (west of UTC). 
-Hours and minutes offset are separated by colons.
-Another format is `[sign][number]`. If `[number]` is less than 24, it is the offset in hours e.g. "-10" = -10 hours. 
-Otherwise it is the offset in houndred hours e.g. "+75" = "+115" = +1.25 hours.
+**Time Zone Format.**  First character is a sign "+" (to the east) or "-" (to the west). 
+Hours and minutes in the UTC offset can be separated by a colon.
+Another format is `[sign][number]`. If `[number]` is less than 24, it is the offset in hours e.g. "-10" = -10 hours.
 
 **Supported Format.**
 
-* `YYYY-MM-DD`, `MM/DD/YYYY`, `MMMM DD YYYY`, `DD MMMM YYYY` — where YYYY is the year, MM is the month of the year, MMMM is the month full name or abbr, and DD is the day of the month ("2000-12-31", "20001231").
+* `YYYY-MM-DD`, `MM/DD/YYYY`, `MMMM DD YYYY`, `DD MMMM YYYY` — where YYYY is the year, MM is the month of the year, 
+  MMMM is the month full name or abbr, and DD is the day of the month.
 * `DATE HH:MM:SS` — Where DATE is the date format discuss above, HH is the hour, 
-  MM is the miute, SS is the seconds ("1995-02-04 24:00:51", "1976-W01-1 12:12:12.123").
+  MM is the miute, SS is the seconds.
 * `DATE TIME +HH:MM`, `DATE TIME -HHMM`, `DATE TIME UTC`
 
 [Add your date formats](./../api.md#date-parser).
@@ -90,8 +90,9 @@ The `format` string follows the same rules as the `strftime` standard C function
 | `%n` | A newline character (`\n`) |  |
 | `%t` | A Tab character (`\t`) |  |
 
+
 **Aliases**:
- 
+
 | Spec | Description | Format | Example |
 |------|-------------|--------|---------|
 | `$c` | Preferred date | `%a %b %d %H:%m%s %Y` | `Tue Jun 23 15:45:01 2020` |
@@ -101,5 +102,6 @@ The `format` string follows the same rules as the `strftime` standard C function
 | `$D` | month/day/year from 01/01/00 | `%m/%d/%y` | `12/02/79` |
 | `$F` | year-month-day | `%Y-%m-%d` | `1979-12-02` |
 
-[Add more aliases](./dev/date.md#aliases)
+
+[Add more aliases](./../api.md#date-format-aliases)
 <!-- {% endraw %} -->

docs/syntax.md

@@ -331,11 +331,32 @@ Arrays and hashes can be nested:
 
 #### Logic operators
 
-* `and`: Returns true if the left and the right operands are both true.
-* `or`: Returns true if the left or the right operand is true.
+* `and`: Returns 'true' value if the left and the right operands are both 'true' value.
+* `or`: Returns 'true' value if the left or the right operand is 'true' value.
 * `not`: Negates a statement.
 * `(expr)`: Groups an expression.
 
+Like control structures, all logical operators consider `false`, `nil` and other [false-values](./spec.md#working-with-booleans) 
+as false and anything else as true. 
+The operator `and` returns its first argument if it is false; otherwise, it returns its second argument. 
+The operator `or` returns its first argument if it is not false; otherwise, it returns its second argument:
+
+```twig
+{{ 4 and 5 }}         --> 5
+{{ nil and 13 }}      --> nil    --> empty string
+{{ false and 13 }}    --> false  --> empty string
+{{ 4 or 5 }}          --> 4
+{{ false or 5 }}      --> 5
+```
+
+Useful for default values:
+
+```twig
+{{ form.text(x or y) }}
+```
+
+it pass to the macro a default value `v` when `x` is not set (provided that `x` is not set to false).
+
 #### Comparisons operators
 
 The following comparison operators are supported in any expression: `==`, `!=`, `<`, `>`, `>=`, and `<=`.