Skip to content

Commit 51366c8

Browse files
committed
docs(skills): align command references
1 parent bf4a867 commit 51366c8

2 files changed

Lines changed: 12 additions & 7 deletions

File tree

skills/atla-cli/references/confluence.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,8 @@ the next logical page. Table output prints a ready-to-copy next command; JSON ou
99
includes `pagination.nextPageToken` and `pagination.nextCommand`; CSV/keys keep stdout
1010
record-only and write the next-page hint to stderr. Pass `--page-token` back to the same
1111
command/query to continue. Use `--all` when you want every matching record; `--all` is
12-
mutually exclusive with both `--limit` and `--page-token`.
12+
mutually exclusive with both `--limit` and `--page-token`. All paginating syntaxes below
13+
also accept `--all` in place of `--limit`/`--page-token`.
1314

1415
---
1516

@@ -53,10 +54,11 @@ atla confluence page list [-s SPACE | --space-id ID] [--title TEXT] [--limit N=2
5354

5455
### View a page
5556
```
56-
atla confluence page view <ID> [--web] [--format markdown|storage|atlas-doc-format]
57+
atla confluence page view <ID> [--web] [--format markdown|storage|atlas-doc-format] [--with-attachments]
5758
```
5859
- `--format markdown` returns rendered Markdown
59-
- `--web` opens in browser
60+
- `--web` opens it in the browser
61+
- `--with-attachments` also fetches and prints page attachments
6062
- Combine with `--output json` for structured data
6163

6264
### List page children
@@ -156,7 +158,7 @@ atla confluence blog list [-s SPACE | --space-id ID] [--title TEXT] [--limit N=2
156158

157159
### View a blog post
158160
```
159-
atla confluence blog view <ID>
161+
atla confluence blog view <ID> [--format markdown|storage|atlas-doc-format]
160162
```
161163

162164
### Create a blog post
@@ -191,9 +193,9 @@ atla confluence blog label remove <BLOG_ID> <LABEL>
191193
```
192194
atla confluence blog comment list <BLOG_ID> [--limit N=25] [--page-token TOKEN]
193195
atla confluence blog comment add <BLOG_ID> [BODY | --body-file FILE]
194-
atla confluence blog comment delete <BLOG_ID> <COMMENT_ID> [--yes]
195196
[--parent COMMENT_ID]
196197
[--representation storage|wiki|atlas-doc-format|markdown]
198+
atla confluence blog comment delete <BLOG_ID> <COMMENT_ID> [--yes]
197199
```
198200

199201
---
@@ -230,7 +232,7 @@ atla confluence attachment upload <PAGE_ID> <FILE> [--comment TEXT] [--minor-edi
230232

231233
### Download an attachment
232234
```
233-
atla confluence attachment download <ATTACHMENT_ID> [--save-to FILE]
235+
atla confluence attachment download <ATTACHMENT_ID> [--save-to FILE | -f FILE]
234236
```
235237

236238
### Delete an attachment

skills/atla-cli/references/jira.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,8 @@ the next logical page. Table output prints a ready-to-copy next command; JSON ou
99
includes `pagination.nextPageToken` and `pagination.nextCommand`; CSV/keys keep stdout
1010
record-only and write the next-page hint to stderr. Pass `--page-token` back to the same
1111
command/query to continue. Use `--all` when you want every matching record; `--all` is
12-
mutually exclusive with both `--limit` and `--page-token`.
12+
mutually exclusive with both `--limit` and `--page-token`. All paginating syntaxes below
13+
also accept `--all` in place of `--limit`/`--page-token`.
1314

1415
---
1516

@@ -297,11 +298,13 @@ atla jira sprint close <ID>
297298
### Add issues to a sprint
298299
```
299300
atla jira sprint add <ID> --issues KEY,KEY,...
301+
# --issue is accepted as an alias for --issues
300302
```
301303

302304
### Remove issues from a sprint
303305
```
304306
atla jira sprint remove <ID> --issues KEY,KEY,...
307+
# --issue is accepted as an alias for --issues
305308
```
306309

307310
### List sprint issues

0 commit comments

Comments
 (0)