systemctl: update page

[vanvuvuong]

• The page(s) are in the correct platform directory: linux
• 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 PR title conforms to the recommended templates.

[cyqsimon]

Hi, welcome to the project and thanks for your contribution.

The PR looks pretty good, but I have some reservations regarding the description change.

[cyqsimon]

Also as a sidenote, I think this page could use some cleaning up. The inclusion of commands like systemctl mask/unmask and systemctl daemon-reload is questionable due to their very infrequent use.

In my personal opinion and experience, it would be much better to include an example that shows operating on the user daemon (systemctl --user), and an example that shows how to access logs (journalctl). We can discuss this in a separate thread.

[CLAassistant]

All committers have signed the CLA.

[vitorhcl]

In my personal opinion and experience, it would be much better to include an example that shows operating on the user daemon (systemctl --user), and an example that shows how to access logs (journalctl). We can discuss this in a separate thread.

My experience with systemctl is too little to debate which commands we should put in its page, but I agree we should include the most useful commands in its page, as we try to do in all our pages.

Also as a sidenote, I think this page could use some cleaning up. The inclusion of commands like systemctl mask/unmask and systemctl daemon-reload is questionable due to their very infrequent use.

IMO a good solution is to add separate pages for those less used commands and then put in the description that common text that says that some subcommands have their own page, such as examples.

Even though some of them don't have their own options and/or subcommands, a separate page can be useful for showing the most usegul example even if only flobal options are used.

The example will also benefit both from a nice explanation of the purpose of the subcommand and from a nice description of what the example usage actually does :)

[vitorhcl]

In general, the changes look very good to me :)

I have some minor suggestions.

About the issue of the usefulness of the current examples, I agree we can discuss this on another PR/issue.

As a positive sidenote:

I liked the pattern of listing the possible values in the right order when there is enough space for this because it gives for the translators the opportunity of translating the possible values.

This is particularly useful when the reader doesn't know / isn't good at English.

We could maybe use this pattern in other pages too, any more opinions?

[kbdharun]

LGTM, Welcome to tldr and thanks for your contribution.

[cyqsimon]

Okay let's merge!