Help talk:Reading

From ArchWiki
Jump to: navigation, search

Meaning of comment: location in the article

The meaning of a code comment is mentioned in Help:Reading#Regular_user_or_root, which is before Help:Reading#Append.2C_add.2C_create.2C_edit linked throughout the wiki (the Create, Edit and similar redirects). -- Alad (talk) 14:38, 5 July 2016 (UTC)

And what is the problem? We can either avoid the forward reference ("Append to ~/path/to/file) in Help:Reading#Regular_user_or_root or keep the root prompts in Help:Reading#Append.2C_add.2C_create.2C_edit. -- Lahwaacz (talk) 19:02, 5 July 2016 (UTC)
The idea was that linking textedit doesn't mention comments or root prompts. By itself however, the structure of Help:Reading makes sense (if the concept of root prompt is known, demonstrating how to edit system files is easy). Perhaps we should simply generalize the redirects, pointing them to Help:Reading ? -- Alad (talk) 14:08, 26 August 2016 (UTC)

Mention tab completion?

Tab completion makes enabling services and other common commands far easier, also regarding the Installation. I've added a note to the Installation guide for now [1], but I think it's better in the long term to mention it here instead. -- Alad (talk) 14:23, 18 July 2016 (UTC)

Mentioned in [2], but maybe we should point out that some configuration will be needed (Bash#Tab_completion, Zsh#Installation/Zsh#Command completion). -- Lahwaacz (talk) 17:08, 18 July 2016 (UTC)
Another thing, what convention should we use when indicating a certain command can be tab-completed? E.g. Installation_guide#Connect_to_the_Internet uses systemctl stop dhcpcd@<TAB>. -- Alad (talk) 13:59, 11 September 2016 (UTC)
I'm afraid of the possibility that a <TAB> (or similar) tag could become a new catch-all pseudovariable, compare the following examples from Network configuration and systemd:
$ ip address flush dev interface
$ ip address flush dev <TAB>
# systemctl start unit
# systemctl start <TAB>
We hide the meaning of what Tab is completing, and we may still have to explain it somewhere else. Also, Tab can be used to complete pretty much everything in the command line, choosing what to replace with <TAB> and what not could become too arbitrary.
I think we should instead do our best to raise awareness of the tab completion packages in a few "entry" pages, and encourage users to set up and get used to using them, instead of reminding to press Tab in our articles.
In addition to your (old) edits to the installation guide and this Help page, for example, I've done this.
-- Kynikos (talk) 16:43, 26 May 2018 (UTC)
I agree with your points, so I think this can be closed. Relevant installation guide edit: [3] Thanks for the input. -- Alad (talk) 15:54, 27 May 2018 (UTC)