Difference between revisions of "Talk:Installation guide"

From ArchWiki
Jump to: navigation, search
(Change link do syslinux install)
(Is creation of /etc/adjtime needed?: re)
 
(526 intermediate revisions by 66 users not shown)
Line 1: Line 1:
== Read this first before add new suggestion ==
+
== Read this first before adding new suggestions ==
* Point of this page is to ''not'' become another Beginner's guide. It's meant to be a ''concise'' checklist of things to be done. So detailed install instruction should go to [[Beginners' Guide]].
+
* If there is something to discuss which should also affect the Beginner's guide, then do it on [[Talk:Beginners%27_Guide/Installation]]. An advanced user will find this page less bloated and easier to read, so let's KISS.
+
  
==Change link do syslinux install==
+
* The point of this page is to be a ''concise'' checklist of things to be done. Detailed instructions, if they are not specific to the installation process only, belong in wiki articles or upstream documentation describing the respective topics.
 +
* Should you have more complex changes for this guide in mind, create a copy on your user page, and link it here for review; e.g. [[User:Example/Installation guide]].
 +
* systemd tools such as ''hostnamectl'', ''timedatectl'' and ''localectl'' [https://github.com/systemd/systemd/issues/798#issuecomment-126568596 do not work] in the installation chroot environment, so please do not propose to use them in the guide unless you can prove that they have been made to work also in that case. See [https://wiki.archlinux.org/index.php?title=Talk:Beginners%27_guide&oldid=388727#General_problems], [https://wiki.archlinux.org/index.php?title=Talk:Beginners%27_guide&oldid=404695#Replace_commands_with_their_systemd_equivalents], [https://wiki.archlinux.org/index.php?title=Talk:Beginners%27_guide&oldid=418662#Utilizing_systemd_tools] and [https://wiki.archlinux.org/index.php?title=Talk:Installation_guide&oldid=434985#change_configuration_system_from_old_way_to_new_way.28using_systemd_commands.29] for some past discussions about this issue.
 +
* {{ic|localectl list-keymaps}} does not work due to bug {{Bug|46725}}. For the chosen replacement command, see [https://wiki.archlinux.org/index.php?title=Talk:Beginners%27_guide&oldid=435044#localectl].
  
The line
+
-- [[ArchWiki:Administrators|The ArchWiki Administrators]] 22:17, 2 September 2016 (UTC)
See Syslinux configuration
+
__TOC__
sould point to installation:
+
See [[Syslinux#Installation|Syslinux installation]]
+
Because in the configuration section, there is nothing about : "mark the partition active with the boot flag and install the MBR boot code".
+
  
== Change section "Connect to the internet" ==
+
== "See ''foo''" vs "See the ''foo'' article" ==
  
Since the installation guide is now part of the iso image, I'd like to see a few references to the manpages of the necessary tools here, since you cannot open the network related wiki pages. Maybe something like this would be acceptable:
+
:''[Moved from [[Talk:Beginners' guide]]. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 20:29, 12 July 2016 (UTC)]''
  Assuming a wired ethernet connection, running dhclient or dhcpcd is
+
  sufficient to get a lease. Otherwise set up the connection manually
+
  using ip add, wpa_supplicant (WLAN with WPA), pppoe-setup (DSL), etc.
+
  You can also create and use netcfg profiles. Read more in the manpages:
+
  ip(8), wpa_supplicant(8), pppoe(8), netcfg(8), netcfg-profiles(5)
+
A reminder to install the packages for the internet connection in the pacstrap section would also be nice. -- [[User:progandy|progandy]]
+
  
== Suggestions to update this guide as part of ISO ==
+
This revision [https://wiki.archlinux.org/index.php?title=Beginners%27_guide&diff=400266&oldid=400243] added a new mention of "See the ''foo'' article", rather than the more common "See ''foo''". I'd argue former is the better form, and when the guide is viewed from a .txt (if the BG/IG merge completes), the longer wording makes sense as well. Are there opinions against using the longer form throughout the BG? -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 00:13, 18 September 2015 (UTC)
Since this guide is now being included as 'install.txt' in the ISO, it might be beneficial to incorporate the following changes:
+
* Entirely remove the '''1. Download''' section and move it to the Download area of the archlinux.org page. This document here is about installing, not downloading, checking, burning discs or dd'ing. The majority of users reading this have likely already booted up the install medium.
+
* Begin or end the document by mentioning the new archlinux(7) man page which explains the location of important system configuration files
+
# man archlinux
+
* Slightly expand the '''6. Connect to the internet''' section to include the most basic examples of setting up a private network using a dynamic and static IP address. (Right now it's only a single paragraph/line.) It's a vital installation step and should actually be moved to the top as one of the first actions during system setup. This fact should be emphasized.
+
  
Obtain dynamic IP
+
:I'm neutral, so that doesn't count as an opinion against ^^ That said, the long form can only be used with links to entire articles, but more difficultly with links to specific sections such as "See also [[Pacman#pacman crashes the official installation media]]", since in those cases a more natural-sounding long form should be something like "See also the 'pacman crashes the official installation media' section of the [[Pacman]] article", I think, which is clearly ugly to see and use, so consistency is a bit hard to reach. — [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 16:13, 18 September 2015 (UTC)
# dhcpcd
+
  
Set static IP
+
::I guess the proper solution would be to incorporate links in the article text where possible. "See X" gets repetitive fast, anyway. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 14:44, 29 September 2015 (UTC)
# ip link set dev eth0 up
+
# ip addr add 192.168.1.2/24 dev eth0
+
# ip route add default via 192.168.1.1
+
# echo "nameserver 8.8.8.8" >> /etc/resolv.conf
+
  
--[[User:MajorTom|MajorTom]]
+
== pacman-key --populate ==
  
:* I can agree to all your suggestions, I wonder why no one is modifying the wiki. Internet connection setup is the most important part and should be covered more extensively. In addition to your changes, mention the manpages and configuration templates for netcfg and pppoe-setup/connect. The boot medium must at least contain easy accesible information in order to read all pages referenced in the installation guide. There should also be mentioned that elinks is installed and can be used to access the wiki.  --[[User:Progandy|Progandy]] ([[User talk:Progandy|talk]]) 21:50, 24 August 2012 (UTC)
+
:''[Moved from [[Talk:Beginners' guide]]. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 20:38, 12 July 2016 (UTC)]''
  
:* The {{ic|dhcpcd}} network daemon is started automatically: [https://www.archlinux.org/news/install-media-20120804-available/], [https://wiki.archlinux.org/index.php/Beginners%27_Guide#Network_setup], so there's no reason to start it manually. --[[User:DSpider|DSpider]] ([[User talk:DSpider|talk]]) 08:17, 25 August 2012 (UTC)
+
Reference: https://wiki.archlinux.org/index.php?title=Beginners%27_guide&diff=next&oldid=411670
 +
I tried to install Archlinux on my new computer and got stuck. Only using the {{ic|pacman-key --populate archlinux}} helped me. I think I am not the only one having this problem. But why did you undo it? {{Unsigned|20:38, 12 December 2015‎|Sandstorm}}
 +
:This command is already run for the new system (by installation of archlinux-keyring), so running it by hand shouldn't be required for most users. Of course, things can go wrong (how old was the ISO you used to install the system?), but that belongs in Troubleshooting sections of the respective articles, which are linked at the beginning of the guide. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 19:52, 12 December 2015 (UTC)
 +
::I had downloaded the ISO just yesterday, minutes before the install. Only that command installed the keys. Probably I should open a bug if you can confirm the issue?
 +
:::Did you have to run pacman-key after, or before pacstrap? And do you recall what the error messages said exactly? (See also {{Bug|31286}}) -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 20:15, 12 December 2015 (UTC)
 +
::::I had to run after pacstrap. As far as I remember, pacstrap stopped after trying to download the keys. The error message was something like shown in this forum post: https://bbs.archlinux.org/viewtopic.php?id=165367
 +
:::::Well then, as you suggested, I'd open a bug report. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 20:34, 12 December 2015 (UTC)
 +
::::::Done. Could you check if the description is good. I could not find an appropriate category, so I though Packages:Core might be the closest one. https://bugs.archlinux.org/task/47351 --[[User:Sandstorm|Sandstorm]] ([[User talk:Sandstorm|talk]]) 20:48, 12 December 2015 (UTC)
 +
:::::::Thanks, the description looks OK. If the category e.a is not right, [[Special:Contributions/Scimmia|User:Scimmia]] should fix it. :P -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 13:59, 13 December 2015 (UTC)
  
== add a step: setting the clock ==
+
::::::::Hmm, looks like it was closed with "Works for me" ... not very enlightening. All I can suggest is to further improve on [[Pacman/Package signing]] and related articles, and recheck if they're accessible enough from the Beginners' guide. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 21:59, 12 February 2016 (UTC)
  
Lots of things care about the clock being more-or-less correct, e.g. pacman-key will not work at all if the clock is too far out. Lots of brand new computers come with the clock set to something in the distant past, which causes weird problems during the install. [[User:Thetrivialstuff|Thetrivialstuff]] ([[User talk:Thetrivialstuff|talk]]) 23:14, 31 July 2012 (UTC)
+
== timesyncd: add manual date ==
  
I agree, the instructions in "Installation Guide" leaves you without a /etc/adjtime file.
+
:''[Moved from [[Talk:Beginners' guide]]. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 20:44, 12 July 2016 (UTC)]''
The following should be added (taken from beginners guide, but shortened):
+
Set the hardware clock and generate a {{ic|/etc/adjtime}} file with {{ic|# hwclock --systohc --utc}} or {{ic|# hwclock --systohc --localtime}}
+
[[User:Bwid|Bwid]] ([[User talk:Bwid|talk]]) 08:03, 3 March 2013 (UTC)
+
:There's no need for an adjtime file, but it does make sense to have people use {{ic|timedatectl}} from the live media to set the clock correctly. -- [[User:Thestinger|thestinger]] ([[User talk:Thestinger|talk]]) 03:30, 15 March 2013 (UTC)
+
  
== pacman-key --init / populate? ==
+
While the right time isn't as important in the live system as in the installed one, it may still be unexpected to users [https://wiki.archlinux.org/index.php?title=Beginners%27_guide&diff=432465&oldid=431268]. We could instead instruct to specify a date explicitly to timedatectl. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 11:25, 6 July 2016 (UTC)
  
Isn't this a required step? pacstrap does not seem to do it on its own. [[User:Thetrivialstuff|Thetrivialstuff]] ([[User talk:Thetrivialstuff|talk]]) 23:15, 31 July 2012 (UTC)
+
:Is the issue setting the time manually or just setting the time zone? The change you linked to just had setting the time zone. -- [[User:Rdeckard|Rdeckard]] ([[User_talk:Rdeckard|talk]]) 01:29, 9 July 2016 (UTC)
:Edit: Ah; I think this was related to the "set the clock" step -- I see that there is a pacman keyring init in the boot sequence of the latest media, but it (silently?) fails if the local clock is wrong.
+
::https://mailman.archlinux.org/pipermail/arch-releng/2012-July/002708.html --[[User:Bluewind|Bluewind]] ([[User talk:Bluewind|talk]]) 09:10, 1 August 2012 (UTC)
+
  
== Link to UEFI Bootloaders page ==
+
::Well, with setting it manually you'd kill two birds with one stone. The time would be what users expect, but without adding an extra step of little consequence. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 18:35, 12 July 2016 (UTC)
  
Instead of telling the user to install GRUB(2) alone in case of UEFI, direct the reader to the [[UEFI_Bootloaders]] page which provides info about all the UEFI bootloaders capable of booting linux kernel. Also how can I edit the guide, there is no "edit" tab shown on top of the page. Is this page restricted to few authors only? -- [[User:The.ridikulus.rat|Keshav P R]] ([[User talk:The.ridikulus.rat|talk]]) 15:31, 19 August 2012 (UTC)
+
== Switch to systemd-networkd ==
  
==Proposed changes to Beginners' Guide and link to Post-Installation==
+
Next ISOs may use systemd-networkd instead of dhcpcd, see [https://lists.archlinux.org/pipermail/arch-releng/2016-July/003739.html] -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 10:26, 19 July 2016 (UTC)
Some major changes are under discussion in [[Talk:Beginners'_Guide#Guide_restructuring]]: some of them would require adjustments to this very guide, see for example [https://wiki.archlinux.org/index.php?title=Talk%3ABeginners%27_Guide&diff=224578&oldid=224567 this post].
+
  
Please reply in the linked discussion, '''not''' here.
+
== <s>Dual-boot with windows</s> ==
  
-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 12:15, 22 September 2012 (UTC)
+
In the [[Beginners' guide]], this is mentioned in [[Beginners'_guide#Format_the_partitions]], but perhaps this should be linked earlier, e.g. in [[Installation guide#Pre-installation]]. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 12:08, 25 July 2016 (UTC)
  
:I've added the steps in [[Beginners' Guide/Post-Installation]] to this guide, which now directly sends users to [[Beginners' Guide/Extra]].
+
:What about [[Installation_guide#Partition_the_disks]]? — [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 09:51, 26 July 2016 (UTC)
:If however [[Talk:Beginners' Guide#Guide restructuring]] will be implemented as planned, the [[Beginners' Guide]] will have a slightly different installation procedure than this guide, unless this one is updated too.
+
:-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 14:08, 24 September 2012 (UTC)
+
  
::Shouldn't the information be added ''before'' "Unmount leftovers and reboot" ? By the way, the title should mention rebooting, because most likely a kernel update was involved. --[[User:DSpider|DSpider]] ([[User talk:DSpider|talk]]) 14:41, 24 September 2012 (UTC)
+
::[[Installation guide#Partition the disks]] now links to [[Partitioning#Partition scheme]], which in turn links to [[Dual_boot_with_Windows]]. I suppose we could link to [[Dual_boot_with_Windows]] directly and add a summary: "When dual-booting with Windows, special precautions must be taken such as leaving an existing EFI System Partition intact, and avoiding UEFI with MBR partitioning or BIOS with GPT partitioning.", but I'm not sure if that's strictly needed. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 12:21, 9 September 2016 (UTC)
  
:::The link to Post-Installation was the last step of the guide, so that's the line I've replaced with the instructions from Post-Installation.
+
:::Why not be more generic with "If dual-booting with Windows, leave an existing EFI System Partition intact; see [[Dual boot with Windows]] for more caveats."? — [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 14:56, 9 September 2016 (UTC)
:::About rebooting in case of a kernel upgrade, I don't think it's necessary to state that since this guide is aimed at experienced users.
+
:::In any case, any reordering or modification of the various steps should better be approved by a Developer, and probably the forum or the mailing lists are better places than this talk page to involve them in such discussions.
+
:::-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 14:59, 24 September 2012 (UTC)
+
  
::::Yeah, but at this point, you were instructed to reboot. In order to edit {{ic|pacman.conf}}, you need to mount the root partition. And to update your system, you need to chroot into it. It would be better if "Unmount leftovers" was renamed "Unmount leftovers and reboot", and added at the end (before the suggestion to read the instructions from '''Extra'''). --[[User:DSpider|DSpider]] ([[User talk:DSpider|talk]]) 15:07, 24 September 2012 (UTC)
+
::::Or you could kill all the flies with one shot by linking to [[:Category:Getting and installing Arch]] for the extra schemes. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 15:47, 9 September 2016 (UTC)
  
:::::You are still instructed to reboot, aren't you? The "Unmount leftovers" section currently tells you to ''"reboot and then login into the new system with the root account"''. In the "new system", the correct partition is already mounted at /.
+
:::::Great idea, added an entry with [https://wiki.archlinux.org/index.php?title=Category:Getting_and_installing_Arch&diff=450099&oldid=444224]. Not sure what to put in the "Conditions" column; patches welcome. :) -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 18:04, 9 September 2016 (UTC)
:::::Whether or not configuring pacman, updating the system and adding a user would be better done in the chroot before rebooting, it's something that should be discussed with a Developer. I too think that it would make more sense, requiring one less reboot in case of a kernel upgrade.
+
:::::-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 15:18, 24 September 2012 (UTC)
+
:::::Renaming "Unmount leftovers" to "Unmount leftovers and reboot" is safe anyway, so I've done that. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 15:37, 24 September 2012 (UTC)
+
:::::@DSpider: you're quite active on the forum, why don't you propose your idea there? I think it would be interesting to discuss it. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 14:11, 25 September 2012 (UTC)
+
:::::Ok, after reading [https://wiki.archlinux.org/index.php?title=Talk%3AInstallation_Guide&diff=226203&oldid=225070 this] I realize that maybe I haven't been clear enough, so I'll try to explain everything more thoroughly.
+
:::::#The current procedure makes you [[Installation_Guide#Configure_the_system|configure the system]] in the '''chroot''' environment from the '''live''' system.
+
:::::#Then, still in the '''live''' system, it [[Installation_Guide#Unmount and reboot|asks]] you to '''exit''' the chroot, unmount the partitions for the '''new''' system, '''reboot''' and login into the '''new''' system. Now, I refuse to write more explicitly in the guide that you should boot into the '''new''' system, and not again in the '''live''' system, in order to login into the new system.
+
:::::#Since you are now into the '''new''' system ('''not''' the live system), the root partition is mounted at {{ic|/}}, not at {{ic|/mnt/}}, so you should be able to configure pacman, update the system and add a user wihtout chrooting. Now, if you've tested the procedure and really noticed that for some obscure-to-me reason you still need to chroot to /mnt in order to do those operations, please ask for clarifications in the forum because I wouldn't be able to answer any more.
+
:::::Last thing, and I think this is the 3rd or 4th time I write it, I '''agree''' with you that configuring pacman etc. could easily be done in the chroot environment at step 1, but you should '''propose''' that change '''in the forum''' first, since it would be a change in the official installation procedure and I won't take responsibility for that.
+
:::::I think this is the best I can do here, the next step to explain all this could be making a movie or a five-act play, but I hope it's not necessary :)
+
:::::-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 05:56, 30 September 2012 (UTC)
+
  
== Mounting the Swap partition. ==
+
::::::If the column entry should be extended, we can discuss it in the category talk. Thanks for the input, closing -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 09:45, 22 September 2016 (UTC)
  
Just a note to clarify the swap partition is '''NOT''' mounted.
+
== The Great Merge ==
You will get an error message if you try.
+
  
Turning on the partition with ''swapon'' command will have the desired effect of having it activated before you add it to /etc/fstab.
+
:''[Moved from [[Talk:Beginners' guide]]. — [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 11:11, 24 August 2016 (UTC)]''
--[[User:CaptainK|CaptainK]] ([[User talk:CaptainK|talk]]) 07:56, 12 June 2013 (UTC)
+
 
 +
[[#Plan]] reaches closure, and the [[Beginners' guide]] is now comparable in size to the [[Installation guide]]. "Cleanup day" [https://bbs.archlinux.org/viewtopic.php?id=214373] would be a good time to start the merge of both guides, and replace the Beginners' guide, together with translations on this domain, to redirections to the [[Installation guide]].
 +
 
 +
It would be preferable if before then, a TU or dev also brings this up on arch-dev-public for input from the developers, also regarding [[#Page protection]]. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 14:25, 5 July 2016 (UTC)
 +
 
 +
:I agree with extending the redirection to the translations, with the exception of 4 which are actively maintained or have been retranslated recently, so I've flagged them to see if their maintainers want to deal with the merge on their own: [[Beginners' guide (العربية)]], [[Beginners' guide (Español)]], [[Beginners' guide (Русский)]] and [[Beginners' guide (简体中文)]]. — [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 10:58, 6 July 2016 (UTC)
 +
 
 +
:: I will take care of [[Beginners' guide (简体中文)]]. --[[User:Fengchao|Fengchao]] ([[User talk:Fengchao|talk]]) 06:21, 7 July 2016 (UTC)
 +
 
 +
::: Note that typically content is rewritten in the [[Installation guide]], rather than taken literally from the [[Beginners' guide]] (see [[Talk:Installation_guide#BG_merge]]), so my suggestion is to focus translation efforts on the Installation guide, rather than the Beginners' guide. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 17:44, 12 July 2016 (UTC)
 +
 
 +
::: I've redirected all translations apart from the above. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 18:50, 12 July 2016 (UTC)
 +
 
 +
::::There are still some pages left: [https://wiki.archlinux.org/index.php?title=Special%3APrefixIndex&prefix=Beginners%27+Guide&namespace=0&hideredirects=1] -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 07:13, 14 July 2016 (UTC)
 +
 
 +
:::::I've just handled those, but there's more to do at [https://wiki.archlinux.org/index.php?title=Special%3APrefixIndex&prefix=begin&namespace=10]. — [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 10:38, 14 July 2016 (UTC)
 +
 
 +
::::::What's the point of redirecting templates to regular pages? [https://wiki.archlinux.org/index.php?title=Template:Beginners%27_Guide_navigation_(Dansk)&curid=10983&diff=441462&oldid=387477] [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 07:59, 15 July 2016 (UTC)
 +
 
 +
:::::::We were discussing that in [[ArchWiki_talk:Administrators#How_to_archive_templates]], we had a half-baked solution, maybe we should just put it to the vote. — [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 14:28, 16 July 2016 (UTC)
 +
 
 +
::::::::Oops, 154 days and still no reply from me, sorry about that... Thanks for your patience and strong nerves for the future, because unfortunately it's far from being the worst case of my this-year-maybe discussions :P
 +
::::::::In this case, I'd say that the templates can be simply deleted: it's fairly trivial transclusion of one &lt;div> and a couple of links, without any MediaWiki hacks, which can be recreated any time if needed. There is also pretty low probability that beginners' guides will be allowed in the near (less than 10 years) future in general, let alone split across multiple pages requiring navigational template. And if it's needed sometime in the next century, they will most likely have something better than MediaWiki's obscure template syntax.
 +
::::::::-- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 15:13, 16 July 2016 (UTC)
 +
 
 +
:::::::::These redirected templates are a very marginal problem IMO, I don't mind if they stay as redirects or are deleted, but only because the fact that [[ArchWiki_talk:Administrators#How_to_archive_templates]] is still open justifies deciding case by case for the moment. Note that as redirects they don't pollute [[Special:UnusedTemplates]]. I wouldn't like to promote deletion as the official default template archiving method though, but I agree with delaying the resolution of that discussion, there are other priorities right now. — [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 13:57, 18 July 2016 (UTC)
 +
 
 +
::::::::::So I've taken the chance and deleted the BG navigation templates. Let's wait for [[ArchWiki_talk:Administrators#How_to_archive_templates]] with the general decision, hopefully this year... -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 18:06, 25 July 2016 (UTC)
 +
 
 +
=== Main page link ===
 +
 
 +
Before redirecting we have to decide at least how to rebalance the links in the [[Main page]]: what about also removing the [[Arch Linux press coverage]] link from the left colum? That article is pretty much unmaintained anyway, we can give it more backlinks from somewhere else. — [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 11:04, 6 July 2016 (UTC)
 +
 
 +
:+1 from me -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 11:30, 6 July 2016 (UTC)
 +
 
 +
Let's not forget that we must also patch [https://git.archlinux.org/archweb.git/tree/templates/public/index.html#n116 the main home page]. — [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 10:14, 13 July 2016 (UTC)
 +
 
 +
:https://lists.archlinux.org/pipermail/arch-projects/2016-August/004400.html -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 05:46, 26 August 2016 (UTC)
 +
 
 +
::FWIW, the links on reddit were fixed, as well as [[phrik]] factoids in the [[IRC]] channel. Let's hope the main page patch gets merged before next year. :P -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 22:31, 2 September 2016 (UTC)
 +
 
 +
=== Translations ===
 +
 
 +
The translations of the [[Main page]] should be updated along with the English page. Also the [https://wiki.archlinux.org/index.php/Special:WhatLinksHere/Beginners%27_guide_(%E6%AD%A3%E9%AB%94%E4%B8%AD%E6%96%87) backlinks] of the BG translations should be cleaned as much as possible, as that might be somewhat [https://wiki.archlinux.org/index.php?title=Beginners%27_guide_(%E6%AD%A3%E9%AB%94%E4%B8%AD%E6%96%87)&diff=443707&oldid=443682 confusing] for future translators. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 11:45, 30 July 2016 (UTC)
 +
 
 +
:Oh jolly... can we automate this with a bot somehow? -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 18:12, 30 July 2016 (UTC)
 +
 
 +
::I haven't been doing any natural language processing yet, but if you feel like teaching my bot Chinese, please help yourself :)
 +
::Just kidding, I could probably make some semi-automatic assistant to at least quickly find and mark the links and open vimdiff for manual editing.
 +
::-- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 18:23, 30 July 2016 (UTC)
 +
 
 +
:::I've fixed most of the backlinks to the english article, as well as the translated [[Main page]] articles. For the backlinks to translations I could definitely use the help of an assistant. :P -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 00:35, 27 August 2016 (UTC)
 +
 
 +
== Clarifications ==
 +
 
 +
:''For reference, see [https://wiki.archlinux.org/index.php?title=Installation_guide&oldid=447678] for the last revision of the Beginners' guide before the redirect. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 10:00, 31 August 2016 (UTC)''
 +
 
 +
=== <s>Partition the disks</s> ===
 +
 
 +
A section on how to identify the devices is completely missing
 +
 
 +
: [https://wiki.archlinux.org/index.php?title=Core_utilities&diff=449129&oldid=448817], [https://wiki.archlinux.org/index.php?title=Installation_guide&type=revision&diff=449132&oldid=448865] - it made no sense to have this hidden away in [[Core utilities#lsblk]]. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 21:25, 2 September 2016 (UTC)
 +
 
 +
The old page provided a very succinct introduction to partitioning, clear examples as well as appropriate warnings that data loss will incur if used incorrectly
 +
 
 +
The new page provides none of that, rather linking to many separate pages not as extra information or for less common use cases as is common in the Beginners' guide but rather as the only way to accomplish the task, it never actually answers the question "What do I need to do?"
 +
 
 +
--[[User:Alexendoo|Alexendoo]] ([[User talk:Alexendoo|talk]]) 12:28, 24 August 2016 (UTC)
 +
 
 +
:It doesn't tell you what you need to do, it assumes that you know that and it therefore provides the steps in the correct order. This is consistent with documentation for competent users. [[User:Jasonwryan|Jasonwryan]] ([[User talk:Jasonwryan|talk]]) 06:04, 31 August 2016 (UTC)
 +
 
 +
:: Is [https://wiki.archlinux.org/index.php?title=Installation_guide&diff=450952&oldid=450473] acceptable for both parties? -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 21:44, 16 September 2016 (UTC)
 +
 
 +
::: No response so I can assume it is. Closing -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 09:49, 22 September 2016 (UTC)
 +
 
 +
In my opinion it is worth mentioning that this is at this stage that the user will decide between a swap partition and a swap file, and link to the [[Swap]] page. Also, we should maintain consistency for naming the swap space: [[Swap]] talks about a swap ''space'' whereas the Installation guide mentions swap area or swap device. Finally, it could be mentioned that the [[Partitioning]] page contains partition scheme suggestions. [[User:Zeb|zeb]] ([[User talk:Zeb|talk]]) 11:12, 3 September 2016 (UTC)
 +
 
 +
:Good points. For the swap terms, see [https://wiki.archlinux.org/index.php?title=Installation_guide&diff=449528&oldid=449526] and [https://wiki.archlinux.org/index.php?title=Installation_guide&diff=449538&oldid=449534] -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 14:44, 5 September 2016 (UTC)
 +
 
 +
::Swap partition vs. swap file is mentioned with [https://wiki.archlinux.org/index.php?title=Installation_guide&diff=449974&oldid=449972] -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 23:10, 8 September 2016 (UTC)
 +
 
 +
=== <s>Format the partitions</s> ===
 +
 
 +
Similar story again, the new guide fails to answer the question "What do I need to do?", it abstracts away to the page on filesystem article that bombards a new user with 16 different filesystems instead of the common case the beginners guide provided: it mentioned explicitly it's recommended to use ext4
 +
 
 +
--[[User:Alexendoo|Alexendoo]] ([[User talk:Alexendoo|talk]]) 12:28, 24 August 2016 (UTC)
 +
 
 +
:It tells you you need to format the partitions that you just created. How you do that is up to you. Again, a level of competency is assumed. [[User:Jasonwryan|Jasonwryan]] ([[User talk:Jasonwryan|talk]]) 06:08, 31 August 2016 (UTC)
 +
 
 +
:: One short example, similar to the one added to [[Installation_guide#Mount_the_file_systems]], could not do any harm though. ([[User:Zeb|zeb]] ([[User talk:Zeb|talk]]) 09:31, 3 September 2016 (UTC))
 +
 
 +
::: Via [https://wiki.archlinux.org/index.php?title=Installation_guide&type=revision&diff=450993&oldid=450962]. I've also extended the [[File systems]] article. [https://wiki.archlinux.org/index.php?title=File_systems&diff=450986&oldid=449874] Closing -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 14:46, 17 September 2016 (UTC)
 +
 
 +
=== Mount the partitions ===
 +
 
 +
Instead of providing two short examples the user is asked to read the manpage for mount, for a beginner this is pretty unnecessary. They're then told to create directories but not told how
 +
 
 +
--[[User:Alexendoo|Alexendoo]] ([[User talk:Alexendoo|talk]]) 12:28, 24 August 2016 (UTC)
 +
 
 +
:Beginners, like everyone else, are expected to read man pages; that isn't "unnecessary". [[User:Jasonwryan|Jasonwryan]] ([[User talk:Jasonwryan|talk]]) 06:10, 31 August 2016 (UTC)
 +
 
 +
: Regarding "mount" I think we should link to [[Mount]] from the installation guide and then we can link to the manpage from there. -- [[User:Rdeckard|Rdeckard]] ([[User_talk:Rdeckard|talk]]) 12:31, 25 August 2016 (UTC)
 +
 
 +
::Ok, though we should make some edits to the [[mount]] article. It's structured oddly, e.g the first section is a convoluted zgrep line.
 +
::For the examples, the main reason I've left them out is because the Beginners' guide used a horrid "/dev/sdxy, where x is ... and y ..." scheme. Though if you're following along, it should be pretty clear what a command like {{ic|mount ''/dev/sda1'' /mnt}} means. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 13:32, 25 August 2016 (UTC)
 +
 
 +
:::I've proposed to merge the [[Mount]] article to [[File systems]], see [[Talk:Mount#Merge to file systems]]. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 14:49, 17 September 2016 (UTC)
 +
 
 +
Mount the partion was easier to follow in the beginners guide, what I kind of miss is the explicit command example of first creating and then mounting a subdir of root (yes I know that it should be clear how to do that, but it wasn't for me at first before I read about what chrooting does) -- [https://www.reddit.com/r/archlinux/comments/4z7z0i/the_beginners_guide_has_been_removed_from_the_wiki/d6ui70e /u/youguess]
 +
 
 +
:I also wonder on the sentence "If you want ''them'' to be detected by genfstab". {{ic|/boot}} will have to be mounted either way to write the kernel to the boot partition, for example. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 18:52, 29 August 2016 (UTC)
 +
 
 +
We could link "create directories" to the man page for mkdir {{man|1|mkdir}}. ([[User:Zeb|zeb]] ([[User talk:Zeb|talk]]) 09:31, 3 September 2016 (UTC))
 +
 
 +
:I wonder if it would make more sense to expand [[Help:Reading]] to mention ''mkdir''. We already rely on it implicitely ("edit", "uncomment", "create", etc.) -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 15:12, 3 September 2016 (UTC)
 +
 
 +
::''mkdir'' is a command; "edit", "uncomment", "create" etc., are actions that can be accomplished with a variety of different commands. If we are to create entries for every basic command, we may as well rename this the GNU/Linux wiki. [[User:Jasonwryan|Jasonwryan]] ([[User talk:Jasonwryan|talk]]) 03:22, 4 September 2016 (UTC)
 +
 
 +
::: I've linked "Create directories" to [[Core_utilities#mkdir]]; it's not straightforward to use man templates as wiki links (see [[Template_talk:Man]]). For [[Help:Reading]], it's not a far stretch to go from "Create a file" to "Create a directory", so I've opened an item in [[Help_talk:Reading#Creating_directories]]. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 12:07, 4 September 2016 (UTC)
 +
 
 +
=== Initramfs ===
 +
 
 +
It's not mentioned that most users don't need to worry about this section
 +
 
 +
--[[User:Alexendoo|Alexendoo]] ([[User talk:Alexendoo|talk]]) 12:28, 24 August 2016 (UTC)
 +
 
 +
Initramfs, maybe add some examples like "eg encrypting/btrfs hook" so that beginners know what it is for? -- [https://www.reddit.com/r/archlinux/comments/4z7z0i/the_beginners_guide_has_been_removed_from_the_wiki/d6ui70e /u/youguess]
 +
: I'm not sure how to best word this. [[Installation_guide#Partition_the_disks]] mentions:
 +
:: If wanting to create any stacked block devices for LVM, disk encryption or RAID, do it now.
 +
: and each of those articles mention you need to edit {{ic|mkinitcpio.conf}} already. "When" may be an unfortunate wording, however - since this step is indeed optional. <s>See also [[#Initramfs]].</s> -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 18:34, 26 August 2016 (UTC)
 +
 
 +
=== A note for Xen users ===
 +
 
 +
For Xen PV VMs, the hwclock --systohc --utc command does not need to be run. Please update the article. [[User:RudyValencia|RudyValencia]] ([[User talk:RudyValencia|talk]]) 12:07, 1 August 2016 (UTC)
 +
 
 +
:This guide isn't meant to account for every special use case a user might have. Add something to the [[Time]] article if you think this is relevant. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 13:09, 1 August 2016 (UTC)
 +
 
 +
::On second thought, I assume this applies to other [[virtual machine]]s as well? -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 13:35, 1 August 2016 (UTC)
 +
 
 +
::: To be honest, running {{ic|hwclock --systohc --utc}} is hardly required if you plan to run a desktop enviroment, since most DEs can automatically set up your clock. But I agree that this should better be stated in the [[Time]] article [[User:Jujstme|Jujstme]] ([[User talk:Jujstme|talk]]) 14:38, 24 August 2016 (UTC)
 +
 
 +
:::: It's something that could fit [[General recommendations]], yeah. That said, I'd say people should at least know on the UTC/localtime difference. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 16:47, 24 August 2016 (UTC)
 +
 
 +
=== <s>Relation between /boot filesystem and boot loader</s> ===
 +
 
 +
As suggested in [[#Other partitions may be needed" - needs expanding]], it could be helpful to indicate the relation between {{ic|/boot}} file system and [[:Category:Boot loaders]] early in the article, e.g.:
 +
:File systems are created using mkfs(8), or mkswap(8) in case of the swap area. ''The {{ic|/boot}} file system must be supported by the chosen [[#Boot loader]].''
 +
-- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 22:25, 2 September 2016 (UTC)
 +
 
 +
:Mentioned in [[File systems]] with [https://wiki.archlinux.org/index.php?title=File_systems&diff=450986&oldid=449874], the hint is given by "formatted with an ''appropriate'' file system". Closing -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 14:48, 17 September 2016 (UTC)
 +
 
 +
=== Notes ===
 +
 
 +
I've left some notes in [[User:Alad/Sandbox#Installation guide]], if anyone is interested in making suggestions. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 09:49, 22 September 2016 (UTC)
 +
 
 +
== <s>Mistake</s> ==
 +
 
 +
In [[Installation guide#Hostname|Hostname]] section is mistake on 4th line. The localhost IP is 127.0.0.1, not 127.0.1.1. --[[User:Conder|Conder]] ([[User talk:Conder|talk]]) 15:43, 18 September 2016 (UTC)
 +
 
 +
:It's not an entry for {{ic|localhost}}, but for {{ic|myhostname}}. See [[Network_configuration#Local_network_hostname_resolution]]. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 18:14, 18 September 2016 (UTC)
 +
 
 +
:It doesn't really matter since the full 127.0.0.0/8 range (i.e. 127.*.*.*) is reserved for loopback: see [[w:Localhost#Name_resolution]]. The choice of 127.0.1.1 is in line with Debian, see [https://www.debian.org/doc/manuals/debian-reference/ch05.en.html#_the_hostname_resolution] and [https://lists.debian.org/debian-devel/2013/07/msg00809.html] for some discussion on the issue. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 13:51, 19 September 2016 (UTC)
 +
 
 +
== Is creation of /etc/adjtime needed? ==
 +
 
 +
Under [[Installation_guide#Time_zone]] we have an {{ic|hwclock}} command that generates {{ic|/etc/adjtime}}, setting the hardware clock to UTC. Is this necessary since systemd already assumes the hardware clock is UTC ([[Time#Time_standard]])?
 +
 
 +
Also, is {{ic|--utc}} supposed to be italicized in the command? There's no indication to the user on what other option would be placed there. The only other option I think is {{ic|--localtime}}. If neither flag is given, then the default is UTC. [[User:Rdeckard|Rdeckard]] ([[User_talk:Rdeckard|talk]]) 15:56, 23 September 2016 (UTC)
 +
:I'm using LOCAL. There's a good reason to not use it, IOW to not explain how to use it by the installation guide.
 +
 
 +
$ timedatectl status | tail -6
 +
Warning: The system is configured to read the RTC time in the local time zone.
 +
          This mode can not be fully supported. It will create various problems
 +
          with time zone changes and daylight saving time adjustments. The RTC
 +
          time is never updated, it relies on external facilities to maintain it.
 +
          If at all possible, use RTC in UTC by calling
 +
          'timedatectl set-local-rtc 0'.
 +
:[[User:Ralf mardorf|Ralf mardorf]] ([[User talk:Ralf mardorf|talk]]) 17:47, 23 September 2016 (UTC)
 +
 
 +
::Right. My point was, does {{ic|hwclock}} even need to be called since UTC is the default? Also I think {{ic|--utc}} being italicized is a typo, since that indicates a pseudovariable. [[User:Rdeckard|Rdeckard]] ([[User_talk:Rdeckard|talk]]) 18:00, 23 September 2016 (UTC)
 +
 
 +
== systemd-firstboot for locale, timezone, and hostname? ==
 +
 
 +
{{ic|systemd-firstboot}} works in a arch-chroot environment. I've tested it on a new installation. There are a couple of ways that it can be used. I think the simplest is:
 +
 
 +
# systemd-firstboot --prompt
 +
 
 +
There the program prompts a user to select a locale from a list of generate locales, the timezone (again from a list of available), and set the hostname. The program outputs what changes are made when performed. For example, when setting the timezone it states {{ic|/etc/localtime written}}.
 +
 
 +
A section that used this method might look like this [[User:Rdeckard/Firstboot]], replacing the current locale, timezone, and hostname sections. [[User:Rdeckard|Rdeckard]] ([[User_talk:Rdeckard|talk]]) 16:16, 23 September 2016 (UTC)

Latest revision as of 18:00, 23 September 2016

Read this first before adding new suggestions

  • The point of this page is to be a concise checklist of things to be done. Detailed instructions, if they are not specific to the installation process only, belong in wiki articles or upstream documentation describing the respective topics.
  • Should you have more complex changes for this guide in mind, create a copy on your user page, and link it here for review; e.g. User:Example/Installation guide.
  • systemd tools such as hostnamectl, timedatectl and localectl do not work in the installation chroot environment, so please do not propose to use them in the guide unless you can prove that they have been made to work also in that case. See [1], [2], [3] and [4] for some past discussions about this issue.
  • localectl list-keymaps does not work due to bug FS#46725. For the chosen replacement command, see [5].

-- The ArchWiki Administrators 22:17, 2 September 2016 (UTC)

"See foo" vs "See the foo article"

[Moved from Talk:Beginners' guide. -- Alad (talk) 20:29, 12 July 2016 (UTC)]

This revision [6] added a new mention of "See the foo article", rather than the more common "See foo". I'd argue former is the better form, and when the guide is viewed from a .txt (if the BG/IG merge completes), the longer wording makes sense as well. Are there opinions against using the longer form throughout the BG? -- Alad (talk) 00:13, 18 September 2015 (UTC)

I'm neutral, so that doesn't count as an opinion against ^^ That said, the long form can only be used with links to entire articles, but more difficultly with links to specific sections such as "See also Pacman#pacman crashes the official installation media", since in those cases a more natural-sounding long form should be something like "See also the 'pacman crashes the official installation media' section of the Pacman article", I think, which is clearly ugly to see and use, so consistency is a bit hard to reach. — Kynikos (talk) 16:13, 18 September 2015 (UTC)
I guess the proper solution would be to incorporate links in the article text where possible. "See X" gets repetitive fast, anyway. -- Alad (talk) 14:44, 29 September 2015 (UTC)

pacman-key --populate

[Moved from Talk:Beginners' guide. -- Alad (talk) 20:38, 12 July 2016 (UTC)]

Reference: https://wiki.archlinux.org/index.php?title=Beginners%27_guide&diff=next&oldid=411670 I tried to install Archlinux on my new computer and got stuck. Only using the pacman-key --populate archlinux helped me. I think I am not the only one having this problem. But why did you undo it? —This unsigned comment is by Sandstorm (talk) 20:38, 12 December 2015‎. Please sign your posts with ~~~~!

This command is already run for the new system (by installation of archlinux-keyring), so running it by hand shouldn't be required for most users. Of course, things can go wrong (how old was the ISO you used to install the system?), but that belongs in Troubleshooting sections of the respective articles, which are linked at the beginning of the guide. -- Alad (talk) 19:52, 12 December 2015 (UTC)
I had downloaded the ISO just yesterday, minutes before the install. Only that command installed the keys. Probably I should open a bug if you can confirm the issue?
Did you have to run pacman-key after, or before pacstrap? And do you recall what the error messages said exactly? (See also FS#31286) -- Alad (talk) 20:15, 12 December 2015 (UTC)
I had to run after pacstrap. As far as I remember, pacstrap stopped after trying to download the keys. The error message was something like shown in this forum post: https://bbs.archlinux.org/viewtopic.php?id=165367
Well then, as you suggested, I'd open a bug report. -- Alad (talk) 20:34, 12 December 2015 (UTC)
Done. Could you check if the description is good. I could not find an appropriate category, so I though Packages:Core might be the closest one. https://bugs.archlinux.org/task/47351 --Sandstorm (talk) 20:48, 12 December 2015 (UTC)
Thanks, the description looks OK. If the category e.a is not right, User:Scimmia should fix it. :P -- Alad (talk) 13:59, 13 December 2015 (UTC)
Hmm, looks like it was closed with "Works for me" ... not very enlightening. All I can suggest is to further improve on Pacman/Package signing and related articles, and recheck if they're accessible enough from the Beginners' guide. -- Alad (talk) 21:59, 12 February 2016 (UTC)

timesyncd: add manual date

[Moved from Talk:Beginners' guide. -- Alad (talk) 20:44, 12 July 2016 (UTC)]

While the right time isn't as important in the live system as in the installed one, it may still be unexpected to users [7]. We could instead instruct to specify a date explicitly to timedatectl. -- Alad (talk) 11:25, 6 July 2016 (UTC)

Is the issue setting the time manually or just setting the time zone? The change you linked to just had setting the time zone. -- Rdeckard (talk) 01:29, 9 July 2016 (UTC)
Well, with setting it manually you'd kill two birds with one stone. The time would be what users expect, but without adding an extra step of little consequence. -- Alad (talk) 18:35, 12 July 2016 (UTC)

Switch to systemd-networkd

Next ISOs may use systemd-networkd instead of dhcpcd, see [8] -- Alad (talk) 10:26, 19 July 2016 (UTC)

Dual-boot with windows

In the Beginners' guide, this is mentioned in Beginners'_guide#Format_the_partitions, but perhaps this should be linked earlier, e.g. in Installation guide#Pre-installation. -- Alad (talk) 12:08, 25 July 2016 (UTC)

What about Installation_guide#Partition_the_disks? — Kynikos (talk) 09:51, 26 July 2016 (UTC)
Installation guide#Partition the disks now links to Partitioning#Partition scheme, which in turn links to Dual_boot_with_Windows. I suppose we could link to Dual_boot_with_Windows directly and add a summary: "When dual-booting with Windows, special precautions must be taken such as leaving an existing EFI System Partition intact, and avoiding UEFI with MBR partitioning or BIOS with GPT partitioning.", but I'm not sure if that's strictly needed. -- Alad (talk) 12:21, 9 September 2016 (UTC)
Why not be more generic with "If dual-booting with Windows, leave an existing EFI System Partition intact; see Dual boot with Windows for more caveats."? — Kynikos (talk) 14:56, 9 September 2016 (UTC)
Or you could kill all the flies with one shot by linking to Category:Getting and installing Arch for the extra schemes. -- Lahwaacz (talk) 15:47, 9 September 2016 (UTC)
Great idea, added an entry with [9]. Not sure what to put in the "Conditions" column; patches welcome. :) -- Alad (talk) 18:04, 9 September 2016 (UTC)
If the column entry should be extended, we can discuss it in the category talk. Thanks for the input, closing -- Alad (talk) 09:45, 22 September 2016 (UTC)

The Great Merge

[Moved from Talk:Beginners' guide. — Kynikos (talk) 11:11, 24 August 2016 (UTC)]

#Plan reaches closure, and the Beginners' guide is now comparable in size to the Installation guide. "Cleanup day" [10] would be a good time to start the merge of both guides, and replace the Beginners' guide, together with translations on this domain, to redirections to the Installation guide.

It would be preferable if before then, a TU or dev also brings this up on arch-dev-public for input from the developers, also regarding #Page protection. -- Alad (talk) 14:25, 5 July 2016 (UTC)

I agree with extending the redirection to the translations, with the exception of 4 which are actively maintained or have been retranslated recently, so I've flagged them to see if their maintainers want to deal with the merge on their own: Beginners' guide (العربية), Beginners' guide (Español), Beginners' guide (Русский) and Beginners' guide (简体中文). — Kynikos (talk) 10:58, 6 July 2016 (UTC)
I will take care of Beginners' guide (简体中文). --Fengchao (talk) 06:21, 7 July 2016 (UTC)
Note that typically content is rewritten in the Installation guide, rather than taken literally from the Beginners' guide (see Talk:Installation_guide#BG_merge), so my suggestion is to focus translation efforts on the Installation guide, rather than the Beginners' guide. -- Alad (talk) 17:44, 12 July 2016 (UTC)
I've redirected all translations apart from the above. -- Alad (talk) 18:50, 12 July 2016 (UTC)
There are still some pages left: [11] -- Lahwaacz (talk) 07:13, 14 July 2016 (UTC)
I've just handled those, but there's more to do at [12]. — Kynikos (talk) 10:38, 14 July 2016 (UTC)
What's the point of redirecting templates to regular pages? [13] Lahwaacz (talk) 07:59, 15 July 2016 (UTC)
We were discussing that in ArchWiki_talk:Administrators#How_to_archive_templates, we had a half-baked solution, maybe we should just put it to the vote. — Kynikos (talk) 14:28, 16 July 2016 (UTC)
Oops, 154 days and still no reply from me, sorry about that... Thanks for your patience and strong nerves for the future, because unfortunately it's far from being the worst case of my this-year-maybe discussions :P
In this case, I'd say that the templates can be simply deleted: it's fairly trivial transclusion of one <div> and a couple of links, without any MediaWiki hacks, which can be recreated any time if needed. There is also pretty low probability that beginners' guides will be allowed in the near (less than 10 years) future in general, let alone split across multiple pages requiring navigational template. And if it's needed sometime in the next century, they will most likely have something better than MediaWiki's obscure template syntax.
-- Lahwaacz (talk) 15:13, 16 July 2016 (UTC)
These redirected templates are a very marginal problem IMO, I don't mind if they stay as redirects or are deleted, but only because the fact that ArchWiki_talk:Administrators#How_to_archive_templates is still open justifies deciding case by case for the moment. Note that as redirects they don't pollute Special:UnusedTemplates. I wouldn't like to promote deletion as the official default template archiving method though, but I agree with delaying the resolution of that discussion, there are other priorities right now. — Kynikos (talk) 13:57, 18 July 2016 (UTC)
So I've taken the chance and deleted the BG navigation templates. Let's wait for ArchWiki_talk:Administrators#How_to_archive_templates with the general decision, hopefully this year... -- Lahwaacz (talk) 18:06, 25 July 2016 (UTC)

Main page link

Before redirecting we have to decide at least how to rebalance the links in the Main page: what about also removing the Arch Linux press coverage link from the left colum? That article is pretty much unmaintained anyway, we can give it more backlinks from somewhere else. — Kynikos (talk) 11:04, 6 July 2016 (UTC)

+1 from me -- Alad (talk) 11:30, 6 July 2016 (UTC)

Let's not forget that we must also patch the main home page. — Kynikos (talk) 10:14, 13 July 2016 (UTC)

https://lists.archlinux.org/pipermail/arch-projects/2016-August/004400.html -- Alad (talk) 05:46, 26 August 2016 (UTC)
FWIW, the links on reddit were fixed, as well as phrik factoids in the IRC channel. Let's hope the main page patch gets merged before next year. :P -- Alad (talk) 22:31, 2 September 2016 (UTC)

Translations

The translations of the Main page should be updated along with the English page. Also the backlinks of the BG translations should be cleaned as much as possible, as that might be somewhat confusing for future translators. -- Lahwaacz (talk) 11:45, 30 July 2016 (UTC)

Oh jolly... can we automate this with a bot somehow? -- Alad (talk) 18:12, 30 July 2016 (UTC)
I haven't been doing any natural language processing yet, but if you feel like teaching my bot Chinese, please help yourself :)
Just kidding, I could probably make some semi-automatic assistant to at least quickly find and mark the links and open vimdiff for manual editing.
-- Lahwaacz (talk) 18:23, 30 July 2016 (UTC)
I've fixed most of the backlinks to the english article, as well as the translated Main page articles. For the backlinks to translations I could definitely use the help of an assistant. :P -- Alad (talk) 00:35, 27 August 2016 (UTC)

Clarifications

For reference, see [14] for the last revision of the Beginners' guide before the redirect. -- Alad (talk) 10:00, 31 August 2016 (UTC)

Partition the disks

A section on how to identify the devices is completely missing

[15], [16] - it made no sense to have this hidden away in Core utilities#lsblk. -- Alad (talk) 21:25, 2 September 2016 (UTC)

The old page provided a very succinct introduction to partitioning, clear examples as well as appropriate warnings that data loss will incur if used incorrectly

The new page provides none of that, rather linking to many separate pages not as extra information or for less common use cases as is common in the Beginners' guide but rather as the only way to accomplish the task, it never actually answers the question "What do I need to do?"

--Alexendoo (talk) 12:28, 24 August 2016 (UTC)

It doesn't tell you what you need to do, it assumes that you know that and it therefore provides the steps in the correct order. This is consistent with documentation for competent users. Jasonwryan (talk) 06:04, 31 August 2016 (UTC)
Is [17] acceptable for both parties? -- Alad (talk) 21:44, 16 September 2016 (UTC)
No response so I can assume it is. Closing -- Alad (talk) 09:49, 22 September 2016 (UTC)

In my opinion it is worth mentioning that this is at this stage that the user will decide between a swap partition and a swap file, and link to the Swap page. Also, we should maintain consistency for naming the swap space: Swap talks about a swap space whereas the Installation guide mentions swap area or swap device. Finally, it could be mentioned that the Partitioning page contains partition scheme suggestions. zeb (talk) 11:12, 3 September 2016 (UTC)

Good points. For the swap terms, see [18] and [19] -- Alad (talk) 14:44, 5 September 2016 (UTC)
Swap partition vs. swap file is mentioned with [20] -- Alad (talk) 23:10, 8 September 2016 (UTC)

Format the partitions

Similar story again, the new guide fails to answer the question "What do I need to do?", it abstracts away to the page on filesystem article that bombards a new user with 16 different filesystems instead of the common case the beginners guide provided: it mentioned explicitly it's recommended to use ext4

--Alexendoo (talk) 12:28, 24 August 2016 (UTC)

It tells you you need to format the partitions that you just created. How you do that is up to you. Again, a level of competency is assumed. Jasonwryan (talk) 06:08, 31 August 2016 (UTC)
One short example, similar to the one added to Installation_guide#Mount_the_file_systems, could not do any harm though. (zeb (talk) 09:31, 3 September 2016 (UTC))
Via [21]. I've also extended the File systems article. [22] Closing -- Alad (talk) 14:46, 17 September 2016 (UTC)

Mount the partitions

Instead of providing two short examples the user is asked to read the manpage for mount, for a beginner this is pretty unnecessary. They're then told to create directories but not told how

--Alexendoo (talk) 12:28, 24 August 2016 (UTC)

Beginners, like everyone else, are expected to read man pages; that isn't "unnecessary". Jasonwryan (talk) 06:10, 31 August 2016 (UTC)
Regarding "mount" I think we should link to Mount from the installation guide and then we can link to the manpage from there. -- Rdeckard (talk) 12:31, 25 August 2016 (UTC)
Ok, though we should make some edits to the mount article. It's structured oddly, e.g the first section is a convoluted zgrep line.
For the examples, the main reason I've left them out is because the Beginners' guide used a horrid "/dev/sdxy, where x is ... and y ..." scheme. Though if you're following along, it should be pretty clear what a command like mount /dev/sda1 /mnt means. -- Alad (talk) 13:32, 25 August 2016 (UTC)
I've proposed to merge the Mount article to File systems, see Talk:Mount#Merge to file systems. -- Alad (talk) 14:49, 17 September 2016 (UTC)

Mount the partion was easier to follow in the beginners guide, what I kind of miss is the explicit command example of first creating and then mounting a subdir of root (yes I know that it should be clear how to do that, but it wasn't for me at first before I read about what chrooting does) -- /u/youguess

I also wonder on the sentence "If you want them to be detected by genfstab". /boot will have to be mounted either way to write the kernel to the boot partition, for example. -- Alad (talk) 18:52, 29 August 2016 (UTC)

We could link "create directories" to the man page for mkdir mkdir(1). (zeb (talk) 09:31, 3 September 2016 (UTC))

I wonder if it would make more sense to expand Help:Reading to mention mkdir. We already rely on it implicitely ("edit", "uncomment", "create", etc.) -- Alad (talk) 15:12, 3 September 2016 (UTC)
mkdir is a command; "edit", "uncomment", "create" etc., are actions that can be accomplished with a variety of different commands. If we are to create entries for every basic command, we may as well rename this the GNU/Linux wiki. Jasonwryan (talk) 03:22, 4 September 2016 (UTC)
I've linked "Create directories" to Core_utilities#mkdir; it's not straightforward to use man templates as wiki links (see Template_talk:Man). For Help:Reading, it's not a far stretch to go from "Create a file" to "Create a directory", so I've opened an item in Help_talk:Reading#Creating_directories. -- Alad (talk) 12:07, 4 September 2016 (UTC)

Initramfs

It's not mentioned that most users don't need to worry about this section

--Alexendoo (talk) 12:28, 24 August 2016 (UTC)

Initramfs, maybe add some examples like "eg encrypting/btrfs hook" so that beginners know what it is for? -- /u/youguess

I'm not sure how to best word this. Installation_guide#Partition_the_disks mentions:
If wanting to create any stacked block devices for LVM, disk encryption or RAID, do it now.
and each of those articles mention you need to edit mkinitcpio.conf already. "When" may be an unfortunate wording, however - since this step is indeed optional. See also #Initramfs. -- Alad (talk) 18:34, 26 August 2016 (UTC)

A note for Xen users

For Xen PV VMs, the hwclock --systohc --utc command does not need to be run. Please update the article. RudyValencia (talk) 12:07, 1 August 2016 (UTC)

This guide isn't meant to account for every special use case a user might have. Add something to the Time article if you think this is relevant. -- Alad (talk) 13:09, 1 August 2016 (UTC)
On second thought, I assume this applies to other virtual machines as well? -- Alad (talk) 13:35, 1 August 2016 (UTC)
To be honest, running hwclock --systohc --utc is hardly required if you plan to run a desktop enviroment, since most DEs can automatically set up your clock. But I agree that this should better be stated in the Time article Jujstme (talk) 14:38, 24 August 2016 (UTC)
It's something that could fit General recommendations, yeah. That said, I'd say people should at least know on the UTC/localtime difference. -- Alad (talk) 16:47, 24 August 2016 (UTC)

Relation between /boot filesystem and boot loader

As suggested in #Other partitions may be needed" - needs expanding, it could be helpful to indicate the relation between /boot file system and Category:Boot loaders early in the article, e.g.:

File systems are created using mkfs(8), or mkswap(8) in case of the swap area. The /boot file system must be supported by the chosen #Boot loader.

-- Alad (talk) 22:25, 2 September 2016 (UTC)

Mentioned in File systems with [23], the hint is given by "formatted with an appropriate file system". Closing -- Alad (talk) 14:48, 17 September 2016 (UTC)

Notes

I've left some notes in User:Alad/Sandbox#Installation guide, if anyone is interested in making suggestions. -- Alad (talk) 09:49, 22 September 2016 (UTC)

Mistake

In Hostname section is mistake on 4th line. The localhost IP is 127.0.0.1, not 127.0.1.1. --Conder (talk) 15:43, 18 September 2016 (UTC)

It's not an entry for localhost, but for myhostname. See Network_configuration#Local_network_hostname_resolution. -- Lahwaacz (talk) 18:14, 18 September 2016 (UTC)
It doesn't really matter since the full 127.0.0.0/8 range (i.e. 127.*.*.*) is reserved for loopback: see w:Localhost#Name_resolution. The choice of 127.0.1.1 is in line with Debian, see [24] and [25] for some discussion on the issue. -- Alad (talk) 13:51, 19 September 2016 (UTC)

Is creation of /etc/adjtime needed?

Under Installation_guide#Time_zone we have an hwclock command that generates /etc/adjtime, setting the hardware clock to UTC. Is this necessary since systemd already assumes the hardware clock is UTC (Time#Time_standard)?

Also, is --utc supposed to be italicized in the command? There's no indication to the user on what other option would be placed there. The only other option I think is --localtime. If neither flag is given, then the default is UTC. Rdeckard (talk) 15:56, 23 September 2016 (UTC)

I'm using LOCAL. There's a good reason to not use it, IOW to not explain how to use it by the installation guide.
$ timedatectl status | tail -6
Warning: The system is configured to read the RTC time in the local time zone.
         This mode can not be fully supported. It will create various problems
         with time zone changes and daylight saving time adjustments. The RTC
         time is never updated, it relies on external facilities to maintain it.
         If at all possible, use RTC in UTC by calling
         'timedatectl set-local-rtc 0'.
Ralf mardorf (talk) 17:47, 23 September 2016 (UTC)
Right. My point was, does hwclock even need to be called since UTC is the default? Also I think --utc being italicized is a typo, since that indicates a pseudovariable. Rdeckard (talk) 18:00, 23 September 2016 (UTC)

systemd-firstboot for locale, timezone, and hostname?

systemd-firstboot works in a arch-chroot environment. I've tested it on a new installation. There are a couple of ways that it can be used. I think the simplest is:

# systemd-firstboot --prompt

There the program prompts a user to select a locale from a list of generate locales, the timezone (again from a list of available), and set the hostname. The program outputs what changes are made when performed. For example, when setting the timezone it states /etc/localtime written.

A section that used this method might look like this User:Rdeckard/Firstboot, replacing the current locale, timezone, and hostname sections. Rdeckard (talk) 16:16, 23 September 2016 (UTC)