exo*: add pages

[davidlazch]

• The page(s) are in the correct platform directories: common, linux, osx, windows, sunos, android, etc.
• The page(s) have at most 8 examples.
• The page description(s) have links to documentation or a homepage.
• The page(s) follow the content guidelines.
• The page(s) follow the style guide.
• The PR title conforms to the recommended templates.
• Version of the command being documented (if known):

[tldr-bot]

The build for this PR failed with the following error(s):

pages/common/exo-dbaas.md:
Error: Parse error on line 4:
...om/community/dbaas/>- List available D
-----------------------^
Expecting 'END_INFORMATION_LINK_URL', got 'NEWLINE'
pages/common/exo-dbaas.md:4: TLDR011 Page never contains more than a single empty line
pages/common/exo-iam.md:
Error: Parse error on line 4:
....com/community/iam/>- List all of the 
-----------------------^
Expecting 'END_INFORMATION_LINK_URL', got 'NEWLINE'
pages/common/exo-iam.md:4: TLDR011 Page never contains more than a single empty line
pages/common/exo-storage.md:
Error: Parse error on line 4:
.../community/storage/>- Create a new SOS
-----------------------^
Expecting 'END_INFORMATION_LINK_URL', got 'NEWLINE'
pages/common/exo-storage.md:4: TLDR011 Page never contains more than a single empty line

Please fix the error(s) and push again.

[Managor]

Not sure what you meant by alias pages.

[CleanMachine1]

Suggested change

	`exo compute instance create --disk-size 10 {{instance_name}} {{[-z|--zone]}} {{zone}} --template '{{Linux Debian 12 (Bookworm) 64-bit}}'`
	`exo compute instance create --disk-size {{10}} {{instance_name}} {{[-z|--zone]}} {{zone}} --template '{{Linux Debian 12 (Bookworm) 64-bit}}'`

[Managor]

It's explicitly stated in the description that the command will create a 10 GB disk so I don't see a placeholder as necessary.

[Managor]

Maybe we should standardize this. #16411

[CleanMachine1]

Given that most software usually has there own scheme for inputting size e.g.

{{size}}{{unit}}

or like this one seemingly

{{size_in_gigabytes}}

and so on, its probably not worth the annoyance of it, there are just edge cases

(also p.s. could probably change {{10}} to be {{size_in_gigabytes}} albeit verbose)

[davidlazch]

I've marked the disk sizes as placeholders everywhere as I can see that there could be confusion behind this.

[CleanMachine1]

Great PR!

[davidlazch]

Not sure what you meant by alias pages.

Found it a bit unclear for the naming convention when there are mass changes for a single command along with its sub commands.

In the templates, as I've understood, if its a sub command of a command its an alias page:

• For a new page addition: ls: add page, docker-container-rm: add alias page

[sebastiaanspeck]

Not sure what you meant by alias pages.

Found it a bit unclear for the naming convention when there are mass changes for a single command along with its sub commands.

In the templates, as I've understood, if its a sub command of a command its an alias page:

• For a new page addition: ls: add page, docker-container-rm: add alias page

An alias page is a page like this: https://github.com/tldr-pages/tldr/blob/main/pages/common/docker-container-rm.md?plain=1. It tells the user it should look to docker rm. For a subcommand (like docker rm) the title would be docker rm: add page. Hope this clarifies things

[Managor]

Correction: docker-rm: add page The title reflects the filename.

[sebastiaanspeck]

Please replace all {{<digits}} with <digits> if the exact same number is mentioned in the description of the example

[sebastiaanspeck]

Suggested change

	`exo compute block-storage create {{volume_name}} --size {{20}} {{[-z|--zone]}} {{zone}}`
	`exo compute block-storage create {{volume_name}} --size 20 {{[-z|--zone]}} {{zone}}`

[sebastiaanspeck]

Suggested change

	`exo compute block-storage update {{volume_name|id}} --size {{30}} --name {{new_name}}`
	`exo compute block-storage update {{volume_name|id}} --size 30 --name {{new_name}}`

[sebastiaanspeck]

Suggested change

	`exo compute instance create --disk-size {{10}} {{instance_name}} {{[-z|--zone]}} {{zone}} --template '{{Linux Debian 12 (Bookworm) 64-bit}}'`
	`exo compute instance create --disk-size 10 {{instance_name}} {{[-z|--zone]}} {{zone}} --template '{{Linux Debian 12 (Bookworm) 64-bit}}'`

[sebastiaanspeck]

Suggested change

	`exo compute instance resize-disk {{instance_name|id}} {{20}}`
	`exo compute instance resize-disk {{instance_name|id}} 20`

[sebastiaanspeck]

Suggested change

	`exo compute sks kubeconfig {{cluster_name|id}} {{user}} --ttl {{1800}} {{[-z|--zone]}} {{zone}}`
	`exo compute sks kubeconfig {{cluster_name|id}} {{user}} --ttl 1800 {{[-z|--zone]}} {{zone}}`