Skip to content

Commit dfd99cf

Browse files
committed
Rename tag into tags
1 parent e932520 commit dfd99cf

File tree

1 file changed

+6
-8
lines changed

1 file changed

+6
-8
lines changed

designs/0002-tags.md

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -22,28 +22,26 @@ These commands can be:
2222

2323
**list commands**:
2424

25-
`thing list --tag <key0>=<value0>,<key1>=<value1>` to list all the things having all the tags passed
25+
`thing list --tags <key0>=<value0>,<key1>=<value1>` to list all the things having all the tags passed
2626

27-
`device list --tag <key0>=<value0>,<key1>=<value1>` to list all the devices having all the tags passed
28-
29-
alternative: `--filter` instead of `--tag`
27+
`device list --tags <key0>=<value0>,<key1>=<value1>` to list all the devices having all the tags passed
3028

3129

3230
**delete commands**:
3331

34-
`thing delete --tag <key0>=<value0>,<key1>=<value1>` to delete all the things having all the tags passed
32+
`thing delete --tags <key0>=<value0>,<key1>=<value1>` to delete all the things having all the tags passed
3533

36-
`device delete --tag <key0>=<value0>,<key1>=<value1>` to delete all the devices having all the tags passed
34+
`device delete --tags <key0>=<value0>,<key1>=<value1>` to delete all the devices having all the tags passed
3735

3836

3937
**ota command**:
4038

41-
`ota upload --device-tag <key0>=<value0>,<key1>=<value1> --file <sketch-file.ino.bin>` to perform an upload via ota to all the devices having all the tags passed
39+
`ota upload --device-tags <key0>=<value0>,<key1>=<value1> --file <sketch-file.ino.bin>` to perform an upload via ota to all the devices having all the tags passed
4240

4341

4442
To be decided, **which flag is mandatory and which is optional**:
4543
In delete and ota commands, the `--id` flag should become **optional** instead of mandatory.
46-
Then, if neither `--id` nor `--tag` is passed, the command could return an error telling the user to specify at least one of the two flags.
44+
Then, if neither `--id` nor `--tags` is passed, the command could return an error telling the user to specify at least one of the two flags.
4745
On the other hand, if both flags are passed, we could follow different approaches: return an error, use only one flag (only tags or only id), try to use both flags.
4846

4947
Another thing to be decided is **how to handle errors**:

0 commit comments

Comments
 (0)