Skip to content

Commit 9e4e9b4

Browse files
committed
Doc: Update "Taskfile versions" documentation
1 parent 6f290f2 commit 9e4e9b4

File tree

1 file changed

+60
-0
lines changed

1 file changed

+60
-0
lines changed

docs/taskfile_versions.md

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -163,3 +163,63 @@ Please check the [documentation][includes]
163163
[output]: usage.md#output-syntax
164164
[ignore_errors]: usage.md#ignore-errors
165165
[includes]: usage.md#including-other-taskfiles
166+
167+
## Version 3
168+
169+
These are some major changes done on `v3`:
170+
171+
- Task's output will now be colored
172+
- Added support for `.env` like files
173+
- Added `label:` setting to task so one can override how the task name
174+
appear in the logs
175+
- A global `method:` was added to allow setting the default method,
176+
and Task's default changed to `checksum`
177+
- Two magic variables were added when using `status:`: `CHECKSUM` and
178+
`TIMESTAMP` which contains, respectively, the md5 checksum and greatest
179+
modification timestamp of the files listed on `sources:`
180+
- Also, the `TASK` variable is always available with the current task name
181+
- CLI variables are always treated as global variables
182+
- Added `dir:` option to `includes` to allow choosing on which directory an
183+
included Taskfile will run:
184+
185+
```yaml
186+
includes:
187+
docs:
188+
taskfile: ./docs
189+
dir: ./docs
190+
```
191+
192+
- Implemented short task syntax. All below syntaxes are equivalent:
193+
194+
```yaml
195+
version: '3'
196+
197+
tasks:
198+
print:
199+
cmds:
200+
- echo "Hello, World!"
201+
```
202+
203+
```yaml
204+
version: '3'
205+
206+
tasks:
207+
print:
208+
- echo "Hello, World!"
209+
```
210+
211+
```yaml
212+
version: '3'
213+
214+
tasks:
215+
print: echo "Hello, World!"
216+
```
217+
218+
- There was a major refactor on how variables are handled. They're now easier
219+
to understand. The `expansions:` setting was removed as it became unncessary.
220+
This is the order in which Task will process variables, each level can see
221+
the variables set by the previous one and override those.
222+
- Environment variables
223+
- Global + CLI variables
224+
- Call variables
225+
- Task variables

0 commit comments

Comments
 (0)