test, [: add page, improve examples

[Rudloff]

• The page (if new), does not already exist in the repo.
• The page is in the correct platform directory (common/, linux/, etc.)
• The page has 8 or fewer examples.
• The PR title conforms to the recommended templates.
• The page follows the content guidelines.
• The page description includes a link to documentation or a homepage (if applicable).

The examples are reused from test.md.

tldr-lint would not let me use [ as the page title.

[bl-ue]

Hey @Rudloff! Wow, this is crazy one...sort of duplicate of another page, also it's name is strange...we should update the linter to allow [ as a page title I guess...

In general, I don't really know what we should do about it, so I'll ask the others who are much more familiar than I am.

[sbrl]

Thanks for the new page, @Rudloff! I've left some comments below for you to review.

@bl-ue: This is a perfectly legit page :P

This isn't even a shell builtin like shopt (which we also have documented) - try executing which [.

If the linter isn't configured to like this, it should be. It's this kinda command that means linting command names or filenames is rather a challenge :P

[bl-ue]

Cool @sbrl. These changes should also be ported to https://github.com/tldr-pages/tldr/blob/master/pages/common/test.md. That page is actually so old (1/8/2016!) and it should be updated in general.
I'll review this PR, too.

[bl-ue]

Sorry @Rudloff now every description and every command has a suggestion 😂

Well, the page this was based on, test.md, is actually really old. It was added in 2015 and modified only once since.

[bl-ue]

We shouldn't merge this though. The title should be changed to [ and we should wait until the linter supports that...

[tldr-bot]

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

pages/common/[.md:1: TLDR013 Title should be alphanumeric with dashes, underscores or spaces

Please fix the error(s) and push again.

[sbrl]

Was the linter updated? I can't remember. There's also the lowercase filenames change that was merged into the linter recently too, so caution is probably advised.

[bl-ue]

@sbrl your PR tldr-pages/tldr-lint#44 is waiting for you 😉

[sbrl]

Thanks, @bl-ue! I've updated there & run jison. I've been busy with life stuff, so haven't had much time for tldr-pages recently :-/

[github-actions]

Hi all! This thread has not had any recent activity.
Are there any updates? Thanks!

[bl-ue]

Sigh. This could really use #5257. /cc @sbrl @owenvoke

[owenvoke]

I'll release a new version of tldr-lint tomorrow if that's ok? Apologies for the delay, I've had other things to do. 👍

[bl-ue]

@owenvoke That would be great! Don't worry about the delay. You're not the only one ;)

[bl-ue]

How do we get the CI to re-run? Nevermind, checks are green as soon as I send! :)

resolved

[bl-ue]

Thank you @Rudloff!

[superatomic]

This PR broke fish shell autocompletion in tldr-pages/tldr-c-client.

Fix: tldr-pages/tldr-c-client#86