- 1 Unification
- 2 Linked to 'parted' Manual doesn't list ext3 or ext4 for fs-type
- 3 Replace parted with cfdisk/cgdisk
- 4 "See foo" vs "See the foo article"
- 5 Redirects to sections
Separate BIOS/MBR and UEFI/GPT descriptions
- 7 General troubleshooting
Utilizing systemd tools
Warning about mounting efivars writable
A single, unified official install guide
Previously, there has been talk here about merging with the old official install guide, and just having a single official Installation Guide. However, that didn't happen when the old guide was removed because the Beginners' Guide was (and is) too long, with too much duplication of other pages after the point where it's necessary (getting the initial network access). In order to be an "official" document, it would also have to be protected - edits by regular users would be proposed on the talk page.
The installation process now always requires network access, and the ISO ships with both a browser and an IRC client, so it's not necessary to keep so much information on this page, since we have very good coverage elsewhere that surpasses the duplication here. For example, there's no need for the Beginners' Guide to explain how to do an upgrade as Pacman#Upgrading packages has much better coverage of the gritty details, and the initial install is already fully upgraded.
- Yes, the ISO comes with a browser ( ), but it's not very good with formatting. Some people may prefer to actually print the guide (which is a waste of paper, if you ask me, but old timers may feel differently), or save it as a PDF/HTML and read it on whatever device they own (smartphone, tablet, etc).
Define scope of the guide
I'd like to define the scope of the guide(s) better and whether it's OK to remove certain things from the wiki instead of marking them as 'the old way' and maybe moving them to a separate article, if needed. Currently the beginners' guide still has info related to initscripts, like setting the timezone, but the article on time has not. -- Karol (talk) 09:56, 30 October 2012 (UTC)
- Right now the Beginner's Guide is "A page where user can get their system installed without reading other pages". This is where the duplications come from. Maybe we can redefine it. So we can:
- # Improve Help:Reading. Add some guide about Navigation, Searching, Category and Table of Contents. So users can reach the information they want more easily.
- # Reduce long duplication texts. The two network configuration part is a candicate. -- Fengchao (talk) 07:46, 31 October 2012 (UTC)
- The reason for using the manual way of configuring is actually because timedatectl and friends won't work from inside a chroot. We could avoid that by having users reboot before configuring this stuff (time, hostname, etc. aren't critical at all) but that would require some minor restructuring, so it's something worth discussing. thestinger (talk) 17:28, 3 November 2012 (UTC)
- [This comment was pasted here from a different, now deleted discussion]
- I think that the goal of the Beginners' Guide is not only to let an Arch novice install the system successfully, but also to introduce him to how an Arch Linux system is structured and the technologies it's based on: we shouldn't think of the Beginners' Guide (or any other article) as a simple howto or step-by-step guide, but as something more formative. -- Kynikos (talk) 15:40, 19 September 2012 (UTC)
If someone was interested and had the time to lay out here a detailed plan with indications on where to merge every section of the guide and a report of all the problems that could be encountered in the process, it would definitely be the final step before announcing the unification on the forums with full support from the admins, which would mean that at that point only strong and reasonable objections could prevent the unification. -- Kynikos (talk) 06:44, 18 August 2013 (UTC)
- Beginners' guide#Prepare the storage devices. See #Replace_parted_with_cfdisk.2Fcgdisk.
- Contains more information on parted than the actual parted, merge back details.
- Improve the fdisk article and use it as a possible method of partioning.
- Information on dual-booting with Windows could be linked earlier in the article.
- Use Category:Partitioning instead of a list of partitioning tools?
- Small TL;DR on difference between BIOS and UEFI, or place it in the UEFI article.
- MBR: limit of 4 partitions and use of Extended partitions. This isn't mentioned in the MBR article, but in GUID Partition Table!
- Beginners' guide#Wireless_2: "processes", elaborate in netctl instead? Also, no reference to the copied configuration file in #Establish an internet connection.
- Lay out remaining differences with the Installation guide, and either merge or discard them on a case-by-case basis.
- Relation between genfstab and swapon.
- Move instructions on BIOS boot order to USB flash installation media.
- Tip on using elinks to browse the guide in another TTY, and irssi to discuss issues from the live environment.
- Make effective use of links so that at most two clicks are required to find the right section.
- Swap is recommended in most cases. 
Tabmore in instructions?
- Examples in
/usr/share/systemd/bootctldon't mention the destination path, the linked systemd-boot does, but a short mention may still be in order
- Beginners'_guide#Connect_to_the_Internet still needs a better structure
Another alternative way to unify the two main guides would be to follow the same philosophy we used to write the scenarios in Dm-crypt_with_LUKS/Encrypting_an_entire_system, originally discussed in Talk:Dm-crypt#New_idea: the new installation guide could be a bare, though complete, list of commands and simple instructions needed to install the system in one example scenario, with links to the various relevant articles for detailed information and adaptations to specific cases. -- Kynikos (talk) 21:18, 27 March 2014 (UTC)
- Well, the Beginners' guide suffers from issues related to both content and style, and I really think they need to be addressed at the same time. Every suggestion so far deals only with one problem.
- Content: I agree that the purpose of the guide (be it Beginners' or Installation) should be to describe only one scenario and provide links to other articles describing the alternatives. I really like this part of your suggestion, but it solves only half of the problem.
- Style: The biggest problem is that Beginners' guide is unique mixture of introduction to reading ArchWiki and introduction to installing and using Arch Linux, which are simply inseparable in the context of BG - you just can't expect newcomers to first read Help:Reading and only then start installing their system. So, there is a little bit of anarchy, as the BG is mostly excused from the style guidelines and there are no guidelines specifically for the BG. Unifying the two guides would necessarily mean a compromise regarding style, which would not be the best for either beginners or gurus.
- Also, I think that it is a good thing that BG is readable without reading other pages (as defined in #Define scope of the guide), because it implies that the most important things have been collected and the readers don't have to click-and-search too much. This is really important for the newcomers, because the orientation in the graph of internal links (I wanted to visualize the graph, but it's just too big) is really difficult - they would need to read dozens of pages (with some alien style applied) before they had the basic system running. On the other hand, one of the main points of BG should be to prepare the readers for other ArchWiki articles, but sometimes the readers are too spoiled.
- Well, that is my defence of keeping both IG and BG. In my opinion it is enough to just properly define the scope of BG and trim it down to ease the maintenance, addressing the content part. But of course if there is a suggestion on merging the two guides addressing the style issues, let's hear it!
- -- Lahwaacz (talk) 11:16, 30 March 2014 (UTC)
- About the style issue, I don't think experienced users would be so bothered by some pacman, systemctl or nano examples, and the unified guide should probably explicitly warn users that they won't find similar examples in the other articles, which would be a perfect way to invite them to become familiar with pacman, systemd, Help:Reading... Besides, if the guide will be properly structured, experienced users who don't have their own custom installation notes will be able to just follow the automatic ToC as a memory refresher.
- I disagree that the fact that the "BG is readable without reading other pages" is a good thing, as that's exactly the reason that makes it hard to maintain and encourages duplication of information; if users were used to follow links instead, most of the efforts now spent in improving the BG would be instead spent in properly improving the linked articles, which would then become as easy to follow as the BG is now.
- Anyway, I've proposed a change in #Comments (under #Plan) that I think should be more likely to reach general consensus, and that would already be a good step forward.
- -- Kynikos (talk) 03:35, 31 March 2014 (UTC)
- I'm beginning to understand the need for merging. After the BG is slimmed down to cover only one example scenario, the title will be just wrong and the scope will be exactly the same as for IG. It all depends on whether different target audience and related style differences are enough to justify two guides.
- I hate being the blocker, so let's slim down BG and when it comes to the point of merging with IG, at least it will not be so shocking. I can't help but to think about it as simple redirecting of BG to IG, which will be (more or less) the eventual outcome, so I will need some time to absorb.
- Finally, we should also look at ArchWiki:Requests#Cleanup: installation category, so that Category:Getting and installing Arch is actually useful for providing alternative scenarios, and to ensure there is a place where to move excessive information from the BG.
- -- Lahwaacz (talk) 07:35, 7 April 2014 (UTC)
- You are not "the blocker", every opinion is as valuable as the others if well argumented, be it for or against the proposal. Especially in this case where we seem to be the only 2 people interested in discussing...
- If the unification will eventually be completed, of course the BG will become a redirect to the IG, and the latter will be unprotected (and well watched so it's not turned again into a BG).
- Let's go on with the change very gradually, that's definitely the best way to let everyone successfully and happily adapt to the new way of following the document, which, if done properly, will be even easier and clearer (no need to compare two guides anymore, just to mention an advantage).
- Of course ArchWiki:Requests#Cleanup: installation category is strictly linked to all this, I'll try to get there too.
- -- Kynikos (talk) 05:26, 9 April 2014 (UTC)
I personally would suggest leaving the Installation guide locked after the merger (even if that would lock me out also :). Thing is, if someone went through the effort of researching an addition to the guide, it would be easy for them to bring it up here, in the talk page, and easier for the community to discuss (and implement, if applicable).
Leaving the Installation guide unprotected however would make it open to hasty edits. Even if the IG were well watched as said, a made edit's context may not be sufficiently clear to "judge" it on the spot (confirmed by ArchWiki:Reports). Having contested content remain (however short) on the main, "official" installation reference is less than ideal.
A compromise may be similar to the IRC page, which is not protected in the technical sense, but has a warning urging users not to edit the page without prior consensus. -- Alad (talk) 23:30, 19 February 2015 (UTC)
- Once upon a time, I absolutely don't even remember where, we even discussed the option of keeping the guide in a protected page, but do all the modifications in a separate open page (as if they were two "master" and "devel" branches), with the admins periodically approving and merging the unstable page into the official one. Thanks to the recently introduced Special:MergeHistory tool, this job could be easier nowadays. — Kynikos (talk) 14:06, 20 February 2015 (UTC)
- That sounds like a good option. Working hypothesis: to make users accustomed to the idea, we could now add a note at the top of the BG, suggesting to first discuss changes on the talk page. After the merger this note would then point to the "development" page. -- Alad (talk) 20:39, 16 March 2015 (UTC)
- @Alad I'm still thinking about it, I'm not sure whether having 2 protected installation guides would be too confusing. The branch method would certainly be well suited if we really ended up merging the guides into one.
- @Lahwaacz The way it would work would be (master is protected, contains the whole revisions history and will not receive direct edits by anyone, including admins):
- develop is initialized with a simple copy of the latest revision of master
- Some users make some edits to develop
- The wiki staff amends/undos develop as necessary with additional edits (like it happens now in the only branch)
- Once develop is considered in a good state, Special:MergeHistory can be used safely, no need for cherry-picking
- Go back to 1 (at this step develop is a redirect to master)
- — Kynikos (talk) 13:09, 17 March 2015 (UTC)
- To add another suggestion, the Talk page of both guides works well in implementing and discussing changes, when used. Often, you see remarks scattered throughout IRC and the forums. As such, we could expand the scope by opening a new thread in the forums, e.g "The Installation Guide thread" and ask it to be made sticky. -- Alad (talk) 17:25, 27 August 2015 (UTC)
- We could even suggest users to make a (partial) copy in their user pages to propose their changes. -- Alad (talk) 10:11, 31 August 2015 (UTC)
- "Everyone could edit the page" defines Wiki/ArchWiki. Be very careful when we want to change that.
- If random edits become maintaince burden, then we could protect it. But keep in mind the protection will definitely prevent some contributions to happen. Installation guide is protected and sometime it got out of date.
- So my suggestion is adding a note like: This is a highly visited page so please discuss any change in talk page first. If it does not work, we could change to a more strict method.--Fengchao (talk) 10:32, 23 January 2016 (UTC)
Linked to 'parted' Manual doesn't list ext3 or ext4 for fs-type
Hi guys. Recent Arch convert here. Loving it. No bloat! Noticed this during Beginners Guid install though:
In the section on using parted ( Beginners'_guide#Partition_schemes ), it links to the Gnu parted manual at http://www.gnu.org/software/parted/manual/parted.html#mkpart for fs-types, but the (rather dated?) manual doesn't list ext3 or ext4. At this point I 'guessed' ext2 was the right choice... Only to find that LATER in the 'Beginners Guide' page it recommended ext4. Damn! Wasn't sure if I had to go back and re-do. Seemed not. But anyway, confusing for 'Beginners'. Anyway, dare not edit the wiki being an Arch noob at this point. Keep up the good work! Cheers. -- Peterg4000 (talk) 00:53, 7 April 2015 (UTC)
- Yes, this is a rather confusing concept: the file system type associated to a partition is a different thing from the file system that you later use to format that partition... It's explained in a bit clearer way in Wikipedia:Disk_partitioning#PC_partition_types, but we should probably explain it better here too.
- In theory, using "ext2", "ext3" or "ext4" when you use
(parted) mkpartshouldn't make any difference at all, as they all set the same partition type code. What does make a difference is the file system you choose when you actually format the partition in Beginners'_guide#Create_filesystems.
- Of course it's wise to make sure the fs-type corresponds to the file system that is going to be used, but even though I've never tested it, I guess you could use e.g. "NTFS" for fs-type and still be able to format the partition with ext4 or whatever file system you want.
- — Kynikos (talk) 13:49, 7 April 2015 (UTC)
- Oh, so for ext3/4 one should just set fs-type to ext2 in parted (etc). Lesson learnt. A one liner would be good saying something like "If you don't know any better, set fs-type to ext2 (Which is the correct option for ext2/3/4), and then format with ext4 below." -- Peterg4000 (talk) 23:32, 7 April 2015 (UTC)
- Actually, parted 3.2 has an explicit label for ext4:
(parted) help mkpart mkpart PART-TYPE [FS-TYPE] START END make a partition ... FS-TYPE is one of: btrfs, nilfs2, ext4, ext3, ext2, fat32, fat16, hfsx, hfs+, hfs, jfs, swsusp, linux-swap(v1), linux-swap(v0), ntfs, reiserfs, hp-ufs, sun-ufs, xfs, apfs2, apfs1, asfs, amufs5, amufs4, amufs3, amufs2, amufs1, amufs0, amufs, affs7, affs6, affs5, affs4, affs3, affs2, affs1, affs0, linux-swap, linux-swap(new), linux-swap(old) ...
- If they are all mapped to the same partition code is another matter, so I'm fine with the current wording. Alternatively we could leave out FS-TYPE completely, after all it is optional (but this is not reflected in the BG).
- -- Lahwaacz (talk) 14:41, 8 April 2015 (UTC)
- Actually, parted 3.2 has an explicit label for ext4:
- Do we want to reopen and investigate this further? Thanks for reminding of the help command, however I can find many sources that seem to confirm that many Linux native file systems (but not all of the above!) map to 0x83:     . Unfortunately, as Wikipedia:Partition_type#Overview says, these codes are not standardized, so we won't be able to find an official reference. Last thing, quoting the manual, " fs-type is required for data partitions (i.e., non-extended partitions)", so I wouldn't leave it out as optional. — Kynikos (talk) 09:46, 9 April 2015 (UTC)
- I wasn't sure where to put this as I'm also new and it's really minor, but also in the parted section when making partitions it says to put 'm' for MiB, this should probably be updated as in my install just 'm' set my sizes to MB not MiB. Suggest updating or preferably instructing the user to define units when entering parted: so set units MiB or GiB or whatever so that just numbers can be used afterwards in creating partitions.Jjex22 (talk) 05:04, 27 August 2015 (UTC)
Replace parted with cfdisk/cgdisk
So, just wanna throw this out there for discussion. I've always found cfdisk/cgdisk to be much more beginner-friendly and intuitive than parted. Since this is the "Beginner's Guide" wouldn't it make sense to recommend using these tools? At the very least, it might be good to mention that they are visual partitioning tools when they are listed in the "partitioning tools" section. Thoughts? -- A Future Pilot (talk) 14:21, 13 July 2015 (UTC)
- Related: 
- I personally wouldn't mind revisiting the topic on fdisk vs. parted (unsure on the benefits of cfdisk or cgdisk - they're not "visual" besides a more-or-less clunky table format, and fdisk has a print switch). This however implies merging Parted content to parted as mentioned in #Plan. -- Alad (talk) 14:53, 13 July 2015 (UTC)
- I personally also favor (c)fdisk. I think it both are very clear for beginners, and they can handle both MBR and GPT (no need for (c)gdisk).
- In any case, I think we should choose a tool which can handle both GPT and MBR partitioning schemes, because otherwise things will get messy again. This is one of the reasons why we changed to parted: it supports both (and back then, there was some question about the stability of fdisk's GPT support, but I'm sure it is fine now; I've personally never has issues). Lonaowna (talk) 17:14, 13 July 2015 (UTC)
- This is obviously too subjective from those being used to one specific tool. I personally find parted to be easier to understand because you write the whole commands instead of just a couple of meaningless letters. Granted, all tools have a help page built in, provide a detailed man page and there is a bunch of "tutorials" for every possible scenario. So, is it even possible to select the "most beginner-friendly" tool or should we decide based on different factor? In any case, there should be only one tool described in detail in the BG and alternatives should be linked to. -- Lahwaacz (talk) 17:23, 13 July 2015 (UTC)
- I agree with your last point, that there should only be one tool described in the BG.
- But I cannot see how we can choose one on other criteria than "beginner-friendly", as all candidates should be able to provide the same functionality. What other factors are there to decide on?
- The only I can think of is that fdisk ( ) is in [core] and , and is not. But both are on the installation ISO, so I'm not sure if that matters at all.
- I am afraid that there is no real criterion to decide by, except for "beginner/user-friendliness", which is indeed subjective. Lonaowna (talk) 21:22, 13 July 2015 (UTC)
- As said, the BG switched from fdisk to parted only a few months ago (which in wiki terms means "yesterday"), so we can't keep going back and forth like in a loop. At this point, I support Alad's proposal above to move the examples to the specialized articles, which also goes in the #Unification direction (and this discussion itself is yet another argument in support of that plan). — Kynikos (talk) 11:49, 15 July 2015 (UTC)
- As proposed in Talk:Partitioning#remove_gdisk_instructions_for_install_medium_2013-11, I've split fdisk: if the BG will become partitioning-tool-agnostic, that article will have to be improved as well. — Kynikos (talk) 04:13, 29 July 2015 (UTC)
"See foo" vs "See the foo article"
This revision  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)
Redirects to sections
- Odd, it didn't work for me (also FF/Noscript) and someone on IRC had a similar issue... I'll try again (with Chromium) and report back. -- Alad (talk) 03:43, 24 August 2015 (UTC)
- Funny (not so much...), it should be #T53736 :( For example I can reproduce it on Firefox by disabling JS with the Web Developer extension. What do we do, do we really start avoiding redirects to sections?? I'm against, I'd rather wait for some kind of fix upstream instead. — Kynikos (talk) 03:55, 24 August 2015 (UTC)
Separate BIOS/MBR and UEFI/GPT descriptions
I wonder whether it'd be better to seperate UEFI/GPT descriptions from BIOS/MBR descriptions, especially for beginners. In current guide, it's mixed in each chapter. What is especially easy to cause mistake for beginner is, GPT is described first in some chapter (e.g. Partition schemes), but MBR is described first in some other chapter (e.g. Create new partition table). At least, the order shall be kept consistent (e.g., always BIOS/MBR first). -- Jarnoshen (talk) 05:50, 1 November 2015 (UTC)
- For the moment I've implemented the second request. 
- About completely separating UEFI from BIOS instructions, I don't think it would simplify the article because we would probably have to duplicate the parts that now are shared between the two standards. Besides, #Replace parted with cfdisk/cgdisk and #Plan will eventually move the problem somewhere else anyway.
- — Kynikos (talk) 02:51, 2 November 2015 (UTC)
Perhaps we should reword:
- The community-maintained ArchWiki is the primary resource that should be consulted if issues arise.
- I wouldn't have particular problems with that, however if we could trust people to actually follow links, that whole second paragraph in the BG intro could be moved into General troubleshooting, and replaced with a link to it. Also, I've proposed some modifications with status templates in that article. — Kynikos (talk) 04:04, 13 December 2015 (UTC)
- Edit: I didn't notice that you had just moved part of Boot debugging into General troubleshooting: as that does go in the direction of reducing the number of links to follow to find info, I think linking to General troubleshooting from the intro of the BG is consistent with it, although I don't know how much it is in the spirit of #Unification. — Kynikos (talk) 04:20, 13 December 2015 (UTC)
Utilizing systemd tools
I think making symlinks and editing files by hand should be replaced with systemd's hostnamectl, timedatectl and localectl. These tools have a very good documentation and all follow the same simple pattern for setting things up. NeoTheFox (talk) 16:40, 26 December 2015 (UTC)
- This was discussed before: , . Is there something new? -- Lahwaacz (talk) 16:58, 26 December 2015 (UTC)
- But why not just reboot and set all these things afterwards? In previous arguments claimed it would require restructuration, but I don't see how it is bad. System would work without setting timezone, locale and hostname. We can also utilize systemd-nspawn to make these work.NeoTheFox (talk) 19:39, 26 December 2015 (UTC)
- Including a large "black box" like systemd-firstboot is a bad idea - it's a very new tool, and if one of the steps fail (assuming it runs at all), users are left with a half-finished install. You'd have to provide background on the steps anyway: for example, locales will still have to be generated by hand.
- Either way, the effort of restructuring was one part of the argument; the other is that the Beginner's guide aims to be formative: newcomers should understand the basic methods before going with the *ctl tools. -- Alad (talk) 22:56, 26 December 2015 (UTC)
- Feel free to create something on your user page. The goal is however to have one installation guide on this wiki, so creating a third one goes directly against that.
- About mentioning *ctl, I suppose you could add a sentence in Beginners' guide#Configuration, and say they can't be used inside the chroot. Though this and other details is already documented in the respective wiki articles (like Time#Time standard). -- Alad (talk) 01:22, 27 December 2015 (UTC)
- I'd like to further clarify Alad's first part of the answer: if you want to share the results of your tests (and it could indeed be interesting to read them), please do in a subpage of your User page, e.g. User:NeoTheFox/Installation with systemd; I'd like to discourage you from taking the time to try to create a new alternative full installation article, since the chances of it being approved for moving into the Main namespace would be near to zero, considering the oppositely-headed #Unification efforts.
- — Kynikos (talk) 04:29, 27 December 2015 (UTC)
Warning about mounting efivars writable
I feel that there should be a warning about making efivars mounted as writable by default, that warning should be exactly as given in the  and then a link to the . I'm not sure exactly where should the post go though. —This unsigned comment is by Jayeshbadwaik (talk) 18:13, 1 February 2016. Please sign your posts with ~~~~!
- Making your efivars partition read-only, when you have to write to it for the installation, is not an installation instruction. This article is strictly limited to latter (it doesn't even instruct to create a regular user account).
- Also, UEFI#UEFI variables is linked right at the beginning of the guide - the warning is just a few paragraphs down. No point in duplicating it here. -- Alad (talk) 17:37, 1 February 2016 (UTC)