diff --git a/README.md b/README.md
index 9bb2073..eac8959 100644
--- a/README.md
+++ b/README.md
@@ -53,7 +53,7 @@ Please consider [sponsoring the project](https://github.com/sponsors/srvaroa) if
### How to trigger action
To trigger the action on events, add a file `.github/workflows/main.yml`
-to your repository:
+to your repository:
```yaml
name: Label PRs
@@ -294,7 +294,7 @@ With this config, the behaviour changes:
## Conditions
-Below are the conditions currently supported in label matchers, in
+Below are the conditions currently supported in label matchers, in
alphabetical order. Some important considerations:
* Conditions evaluate only when they are explicitly added in
@@ -308,20 +308,29 @@ alphabetical order. Some important considerations:
### Age (PRs and Issues)
-This condition is satisfied when the age of the PR or Issue are larger than
-the given one. The age is calculated from the creation date.
+This condition evaluates the creation date of the PR or Issue.
-If you're looking to evaluate on the modification date of the issue or PR,
+If you're looking to evaluate on the modification date of the issue or PR,
check on
This condition is best used when with a schedule trigger.
-Example:
+Examples:
```yaml
-age: 1d
+age:
+ at-most: 1d
```
+Will label PRs or issues that were created at most one day ago.
+
+```yaml
+age:
+ at-least: 1d
+```
+
+Will label PRs or issues that were created at least one day ago.
+
The syntax for values is based on a number, followed by a suffix:
* s: seconds
@@ -412,7 +421,7 @@ This condition is satisfied when any of the PR files matches on the
given regexs.
```yaml
-files:
+files:
- "cmd\\/.*_tests.go"
- ".*\\/subfolder\\/.*\\.md"
```
@@ -425,9 +434,9 @@ and therefore must be escaped itself to appear as a literal in the regex.
### Last Modified (PRs and Issues)
-This condition evaluates the modification date of the PR or Issue.
+This condition evaluates the modification date of the PR or Issue.
-If you're looking to evaluate on the creation date of the issue or PR,
+If you're looking to evaluate on the creation date of the issue or PR,
check on
This condition is best used when with a schedule trigger.
@@ -462,19 +471,19 @@ For example, `2d` means 2 days, `4w` means 4 weeks, and so on.
This condition is satisfied when the [mergeable
state](https://developer.github.com/v3/pulls/#response-1) matches that
-of the PR.
+of the PR.
```yaml
mergeable: True
```
-Will match if the label is mergeable.
+Will match if the label is mergeable.
```yaml
mergeable: False
```
-Will match if the label is not mergeable.
+Will match if the label is not mergeable.
### Size (PRs only)
@@ -518,7 +527,7 @@ file or a Regex expression:
size:
exclude-files: ["yarn.lock", "\\/root\\/.+\\/test.md"]
above: 100
-```
+```
This condition will apply the `L` label if the diff is above 100 lines,
but NOT taking into account changes in `yarn.lock`, or any `test.md`