bun-add: add page

[sri-sethu]

Checklist

Adds a bun add page. Related #19127

• The page(s) are in the correct platform directories: common, linux, osx, windows, sunos, android, etc.
• 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 contains at most 5 new pages.
• The PR is authored by me, or has been human-reviewed if it was created with AI or machine translation software.
• The PR title conforms to the recommended templates.
• Version of the command being documented (if known):

Reference issue: #

[SpikeTheDragon40k]

After we solved the issue poited out by Managor, LGTM

[znarfm]

shouldn't we have an alias page for bun a?

[Managor]

I feel like adding an alias page for every shorthand alias would clutter the tab complete suggestions. This would be at least twice as long if every shorthand had its own documentation

On the other hand if someone is used to using the shorthands from an online guide and tries to find more info about it, the shorthand would be good for pointing the user to the full page.

I'm torn between these two so I wish to have more opinions on the matter.

[znarfm]

Would it be possible if we track alias pages differently, like maybe a central file like a aliases.json or even a toml, which just maps the original pages into their aliases. If ever, tldr clients can read this single file and display the original tldr page for the alias. But, a big challenge is maintenance since that file would get bigger and bigger over time and it would be messy if not sorted alphabetically.

Another option I can think of is maybe creating a symlink into the original command's tldr page, named as the alias command. Similar to how the pages.en/ directory is just a symlink to pages/, but I don't know if this would work as intended yet.

[Managor]

We've had previous discussions about auxiliary files and the conclusion was that having the additional complexity wasn't worth it.

Symlinks on the other hand are something that I haven't thought about and I think I haven't seen anyone discuss it. Would you mind opening a an issue on the issue tracker to discuss it?