https://wiki.archlinux.org/api.php?action=feedcontributions&user=Tmarks&feedformat=atomArchWiki - User contributions [en]2024-03-28T09:55:36ZUser contributionsMediaWiki 1.41.0https://wiki.archlinux.org/index.php?title=Talk:Beginners%27_guide&diff=339700Talk:Beginners' guide2014-10-11T14:24:46Z<p>Tmarks: /* Gummiboot instructions are out of order. */ changed some instances of EFI to ESP.</p>
<hr />
<div>== Unification ==<br />
=== A single, unified official install guide ===<br />
<br />
{{Note|This is based on talk/consensus in #archlinux. The official [[Installation Guide]] page is going to be expanded (or this guide could be protected, cleaned up and replace it - either works, that could be decided here).}}<br />
<br />
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.<br />
<br />
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.<br />
<br />
-- [[User:Thestinger|thestinger]] ([[User talk:Thestinger|talk]]) 21:52, 28 October 2012 (UTC)<br />
<br />
:Yes, the ISO comes with a browser ({{Pkg|elinks}}), 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).<br />
<br />
No need to create a section for this, just reminding that the unification would affect {{Bug|36111}}. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 06:57, 18 August 2013 (UTC)<br />
<br />
=== Define scope of the guide ===<br />
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 [https://wiki.archlinux.org/index.php/Beginners%27_Guide#Time_zone setting the timezone], but the article on time [https://wiki.archlinux.org/index.php/Time#Time_standard has not]. -- [[User:Karol|Karol]] ([[User talk:Karol|talk]]) 09:56, 30 October 2012 (UTC)<br />
: 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:<br />
: # Improve [[Help:Reading]]. Add some guide about Navigation, Searching, Category and Table of Contents. So users can reach the information they want more easily.<br />
: # Reduce long duplication texts. The two network configuration part is a candicate. -- [[User:Fengchao|Fengchao]] ([[User talk:Fengchao|talk]]) 07:46, 31 October 2012 (UTC)<br />
: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. [[User:Thestinger|thestinger]] ([[User talk:Thestinger|talk]]) 17:28, 3 November 2012 (UTC)<br />
<br />
::''[This comment was pasted here from a different, now deleted discussion]''<br />
:: 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. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 15:40, 19 September 2012 (UTC)<br />
<br />
=== Unification Status? ===<br />
Hello,<br />
<br />
Is there any forward motion on unifying or cleaning up the Installation Guides? I would like to lend my hand if or when I earn that ability.<br />
<br />
Both my fiancee and I have recently completed installs of Arch Linux and found ourselves hopping back and forth between the official installation guide and this Beginners Guide. Short of unification, synchronizing the steps would be a huge boon for those that utilize the resources in a similar manner.<br />
<br />
Cheers,<br />
[[User:AdamT|AdamT]] ([[User talk:AdamT|talk]]) 03:35, 24 July 2013 (UTC)<br />
<br />
:While it's more work and kind of a mess sometimes with 2 Guides, if those 2 are well maintained it has the advantage to serve distinct target groups well. If you where to merge into one, i fear you'd either annoy the expierienced Users with unnecessary fluff, or if you cut too much info out of it you'd leave the newbies with open questions. <br />
:Another system would be, have one guide, and on specific topics links to article which will explain those well. But then you would have to but all the verbose-newbiew "explain everything" information into those subarticles. I don't think it would be a better system.<br />
:One thing which i don't like about current state of the Beginners Guide, in some places there is some quite advanced info/adviced included which is only relevant in niche-scenarious. I think those should be moved into the specialized articles on a case by case basis.<br />
:What do you mean when you say "synchronizing the steps"? How would this look like?<br />
:[[User:Bwid|Bwid]] ([[User talk:Bwid|talk]]) 08:22, 24 July 2013 (UTC)<br />
::Hi Bwid,<br />
::I should have clarified with regards to synchronizing the steps between the [[Beginners' Guide]] and the official [[Installation Guide]]. Simply put, the Beginners' Guide completes the installation with steps ordered differently than the Installation Guide.<br />
::Examples:<br />
::*Connecting to the internet<br />
::**Beginners' Guide Section 2.2<br />
::**Installation Guide Section 2.5<br />
::*Configure the System<br />
::**Installation Guide Section 2.7<br />
::**Beginner's Guide Section 2.8<br />
::***Under which the steps are differently ordered compared to the installation guide.<br />
::Going back over this, it does seem a little trite, but if we are going to maintain two separate guides keeping them as close as possible in terms of process seems to be the simpler choice. I am not saying they need to have the same section numbers (though where feasible, that would be ideal I should think), just flow in the same order from start to finish.<br />
::There is something that strikes me as being distinctly not in keeping with [[The Arch Way]] with regards to keeping two separate guides. With that said, assuming for a moment that two guides are a necessary evil, it further seems to go against simplicity by keeping redundant information in the Beginners' Guide that could otherwise be put (and should be put or at least duplicated in my view) in the subject specific Arch Wiki articles so that people that are not just installing, or that may not consider themselves beginners might benefit from the information as well.<br />
::It does not need to be novice user centric, it does not need to be verbose. The sub-articles just need to provide the information that is necessary to properly address a given subject with regards to Arch Linux, which is the point of the subject specific articles as it is. Comprehensiveness is listed as a goal for the Arch Wiki so this should not be something that is feared ([[ArchWiki:About#Comprehensive]]).<br />
::This linking to relevant articles is exactly what the official Installation Guide does, and finding subject specific articles is a skill needed post-install for anyone that continues to use Arch Linux.<br />
::Anyway, I do not intend to talk this to death or to become hyperbolic, this just seemed to have fizzled and I was curious as to its current state. If people are happy with the current state of things regarding the installation guides that works for me I shall focus on other articles! : )<br />
::Cheers!<br />
::[[User:AdamT|AdamT]] ([[User talk:AdamT|talk]]) 18:20, 24 July 2013 (UTC)<br />
:::Actually i think its good that you brought the topic up again. I was wondering along the same lines a while again. Is it worth it spending time working on restructuring the guide when the the thing might be done away with soon? Also don't take my rationalization of the 2 Guides as some sort of common opinion, i am sure there are many who agree that the Beginners Guide shouldnt duplicate Install guide, and even I am not sure about if what I wrote above is true. If the decission is that the BG should be repurposed, and instead the articles which are linked from IG improved then i would be fine with it.<br />
:::[[User:Bwid|Bwid]] ([[User talk:Bwid|talk]]) 19:02, 24 July 2013 (UTC)<br />
::::Technically yes, having only one slim installation guide that links to specific articles is the solution supported by [[User:thestinger|thestinger]] and [[User:Kynikos|me]] (although with slightly different opinions on some things like protection of the article), and IIRC I've never read a word against the idea from other admins.<br />
::::IMO the only big problem that's still holding us back is that we're playing with what's arguably the most visited article of the wiki, which is sometimes seen as kind of a trademark from outside, so everybody (including me) is hesitant about making the final decision that will definitively kill it. Maybe, and I say ''maybe'', we should discuss this on the forums, where we would get many more responses, although a big part of them would probably be against the merge, as many new users do like having as much information as possible in one article without having to click on links. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 13:02, 25 July 2013 (UTC)<br />
:::::Bwid & Kynikos,<br />
:::::I appreciate both of your well reasoned responses. If the time is worth investing, perhaps putting together a third, unified option and then presenting the three on the forums (or however the admins would like) would provide a concise comparison which the community at large could form an educated opinion and decision from?<br />
:::::[[User:AdamT|AdamT]] ([[User talk:AdamT|talk]]) 21:47, 25 July 2013 (UTC)<br />
::::::Sorry I'm not following, what would be the third option? :) -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 04:54, 27 July 2013 (UTC)<br />
:::::::Kynikos,<br />
:::::::No worries. The third option would be a "unified guide" that we could create without removing the existing two (the official Installation Guide and the Beginners' Guide) so that a direct comparison could be made between the existing guides and our proposed unified guide. This would allow the admins to bring the guides before the greater community for a vote on which to use (the current two guides or a singular unified replacement). The risk with this plan is the potential for wasted time in creating a guide that may not ultimately be used. We should also probably commit to deleting the third guide if the community votes against it so as not to make the current situation worse with a third unofficial guide. :)<br />
:::::::I hope this makes my idea clearer.<br />
:::::::Take care,<br />
:::::::[[User:AdamT|AdamT]] ([[User talk:AdamT|talk]]) 18:55, 27 July 2013 (UTC)<br />
::::::::I don't think this third option is feasible without affecting the other two guides, in fact the big part of this whole unification is moving content from the Beginners' Guide to the various specific articles, and the third option wouldn't make sense if we don't do that. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 11:14, 29 July 2013 (UTC)<br />
<br />
====The transclusion way====<br />
I agree with the idea to create a guide for all users. For newbies, the fastest way to achieve the installation step should be written explicitly. Alternative/advanced ways {{ic|(e.g. other bootloaders instead of the default proposed gummiboot for uefi bootloader)}} should be put in a dedicated article {{ic|(to take the same example, the [[Bootloader]] article --> this article could even integrate the introduction section of grub for example. --> We will have recursive inclusions)}}.<br />
<br />
In order to avoid duplication and avoid too much maintenance efforts, we could use the [http://www.mediawiki.org/wiki/Transclusion MediaWiki's transclusion method], which embeds section of internal wiki pages into the current one ([https://www.mediawiki.org/wiki/Extension:Labeled_Section_Transclusion a dedicated extension exists to provide even more advanced inclusions possibilities]). In that way, we maintain all the dedicated pages and include some of their sections to the unified install guide. Pay attention to don't broke the links when editing the dedicated articles. In that way, we will satisfy both kind of users: the advanced ones and the newbies.<br />
<br />
* The advanced ones will check the advanced pages when skimming the unified installation guide. For these users the guide will be like a memento (the current [[Installation Guide]] is thus not needed any more). <br />
* For newbies, it will be a beginner guide which will offer the availability to learn further by reading the linked pages.<br />
<br />
{{bc|<br />
Example:<br />
<br />
Install guide<br />
<br />
5. Add a bootloader<br />
<Include introduction section of the bootloader article: what is a bootloader><br />
<br />
Use the recommended one for UEFI:<br />
<Include standard/easy install section gummiboot install><br />
<br />
etc.<br />
}}<br />
<br />
-- [[User:wget|wget]] ([[User talk:wget|talk]]) 17:57, 4 August 2013 (UTC)<br />
<br />
:Um I thought of this possibility myself a while ago, but then discarded it because it would make maintenance even more difficult, as when editing one of the transcluded articles it should always be taken into account any consequence on the "long" article; in the end, it looks too complicated to me. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 11:50, 5 August 2013 (UTC)<br />
<br />
::This is the reason I wrote "Pay attention to don't broke the links when editing the dedicated articles.". But I think applying this method is the best way to avoid duplication efforts. Take the following example. A guy: "It would be great if we add this new useful tool to establish a wi-fi connection to the beginner guide", another guy checking/watching the network page won't be informed and cannot bring its experience as he won't be informed about these changes written in the install guide.<br />
<br />
::If you're a developer you know what I mean when I say page inclusion is the BEST way to avoid duplication ;-)<br />
::- [[User:wget|wget]] ([[User talk:wget|talk]]) 12:52, 5 August 2013 (UTC)<br />
<br />
:::One big problem I foresee with this method is that we still should maintain two separate installation guides: they should contain the same instructions, but one should contain links to the relevant articles, while the other should transclude the needed article sections; this means this method wouldn't avoid duplication completely :) I still think the "links" way is the simplest and most efficient. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 14:27, 6 August 2013 (UTC)<br />
:::: +1 for links. Based on my old experience, inclusion increase maintenance efforts, you need to consider both pages when editing. And what is worse, it make it harder for new users to contribute because change in one place may influence another page they do not know well. Let us keep it simple :) -- [[User:Fengchao|Fengchao]] ([[User talk:Fengchao|talk]]) 13:23, 11 August 2013 (UTC)<br />
<br />
:Please note that it is crucial that the document aimed at beginners (whether a separate article or not) direct UEFI users for whom gummiboot fails to alternative boot methods. I do not have in mind cases where a complex configuration requires something else but, rather, cases in which the user's firmware will not work with this method. One case is that in which the firmware fails with any method relying on EFISTUB. This is not the standard case but it is not uncommon either. Moreover, all UEFI users should be aware of this because firmware which boots the EFISTUB with this kernel may easily refuse to do so with the next. Any user using UEFI to boot needs to be aware of this possibility and of where to look for work-arounds if it they are hit by the bug(s) at some point. (Almost certainly multiple bugs at work here.) I am reiterating this because the original discussion (complete with forum links) has been removed as closed. That's fine but I worry that people unaware of those issues may easily streamline the new version of the guide in a way which recreates the problem with the same results: lots of confused beginners on the forums, often being directed back to a version of the guide which fails to point them in any useful direction. --[[User:Margali|cfr]] ([[User talk:Margali|talk]]) 23:35, 22 September 2013 (UTC)<br />
<br />
=== Merge two network config sections ===<br />
In my opinion the [[Beginner%27s_Guide#Configure_the_network|network configuration section]] is no longer correct and it should be replaced with the correct section from [[Configuring_Network#Configure_the_IP_address|this page]]. At least, the static IP configuration section does not work for me. This is probably caused by the switch to [[systemd]].<br />
--[[User:Doru001|Doru001]] ([[User talk:Doru001|talk]]) 16:49, 29 January 2013 (UTC)<br />
<br />
Most of this section is a repeat of info already presented earlier in the guide (most notably in [[Beginners'_Guide#Configure_Network_.28Netinstall.29|3.1.1]]).<br />
<br />
I understand that directing users to [[Beginners'_Guide#Configure_Network_.28Netinstall.29|3.1.1]] when they've already got a system up and running isn't that great of an idea since they are no longer in the live environment and some things are different (but not much!), but surely something can be done to reduce the redunancy (especially on the [[Beginners'_Guide#Wireless_LAN|4.1.2 Wireless LAN]] section, which is basically a 1:1 copy of [[Beginners'_Guide#Wireless_Quickstart_For_the_Live_Environment|3.1.1.2]]) [[User:Xgamer99|Xgamer99]] 19:49, 8 January 2011 (EST)<br />
:Went ahead and made the edit, as I can't see anything wrong with it. Please let me know if you disagree. However, I still believe that 4.1 should be re-worked and merged with 3.1.1, and just have 4.1 direct users to it. The only thing that would need to be added is the Proxy settings and manual wired connection (installer handles wired connections flawlessly, so manual activation isn't covered in 3.1.1). [[User:Xgamer99|Xgamer99]] 04:00, 9 January 2011 (EST)<br />
:: Reopen this discuss. Those two network configuration section still exist. They should be merged. -- [[User:Fengchao|Fengchao]] ([[User talk:Fengchao|talk]]) 10:16, 1 August 2012 (UTC)<br />
::: There are [[Beginners%27_Guide#Establish_an_internet_connection]] and [[Beginners%27_Guide#Configure_the_network]] sections. Though they are not 1:1 copy, I agree that they should be merged. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 14:34, 4 August 2013 (UTC)<br />
::::Just to make sure it is clear, there are two sections because one configures the network in the live environment, the other does it in the chroot environment; for example in the first section it's not needed to enable services or netctl profiles. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 11:43, 5 August 2013 (UTC)<br />
:::I disagree, they should not be merged. The first one is just a quick and dirty one-time setup. (As it should be.) The second one is about how to setup a network manager that provides a persistent connection. I think that merging these two will lead to more confusion. (I've already seen lots of people who do not understand that the network has to be configured twice; I think that we should explain the difference more clearly.) --[[User:Lonaowna|Lonaowna]] ([[User talk:Lonaowna|talk]]) 11:53, 5 August 2013 (UTC)<br />
:::: What about put this into another form: Merge common parts into [[Network configuration]] and leave just a link here. -- [[User:Fengchao|Fengchao]] ([[User talk:Fengchao|talk]]) 13:25, 11 August 2013 (UTC)<br />
<br />
=== Plan ===<br />
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. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 06:44, 18 August 2013 (UTC)<br />
<br />
Here is a list of sections that should be merged. Feel free to expand, comment in [[#Comments]]. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 18:26, 31 August 2013 (UTC)<br />
<br />
* <s>[[Beginners' Guide#Graphical User Interface]]<br />
** [[Beginners' Guide#Install X]] - merge into [[Xorg#Installation]], leave only the description of X and link to the target<br />
** [[Beginners' Guide#Install a video driver]] - merge into [[Xorg#Driver installation]], leave only the note in the beginning and link to the target<br />
** [[Beginners' Guide#Install input drivers]] - merge into [[Xorg#Input devices]], leave only note ''in most cases, installing input drivers is not needed'' and links to the target and [[Touchpad Synaptics]]<br />
** [[Beginners' Guide#Test X]] - not sure about this, I'd leave it as it is optional</s><br />
<br />
==== General problems ====<br />
<br />
* ''timedatectl'', ''hostnamectl'', ''localectl'' etc. won't work from inside a chroot, so manual method of configuration is required. This could be avoided by having users reboot before configuring this stuff (time, hostname, etc. aren't critical at all). (mentioned in [[#Define scope of the guide]] by [[User:Thestinger]])<br />
<br />
==== Comments ====<br />
<br />
I think a first step we could take relatively easily would be to completely merge [[Beginners' guide/Post-installation]] and [[Installation guide#Post-installation]] into [[General recommendations]] and [[Xorg]] (following the list above in [[#Plan]]). -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 03:35, 31 March 2014 (UTC)<br />
<br />
:The sections in [[General recommendations]] are sorted alphabetically, however for the merging it would be useful to reorder them by "usefulness" or "importance" - don't know how to measure it, but [[General recommendations#Appearance]] would certainly be the last... -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 06:25, 31 March 2014 (UTC)<br />
<br />
::Of course reordering the sections by importance would be essential. Can I assume you agree with the merge proposal then? -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 00:01, 2 April 2014 (UTC)<br />
<br />
:::Indeed I do, [[General recommendations]] is already much more useful than [[Beginners' guide/Post-installation]], it makes sense to keep things in one place and merge ''this section''. I still have some doubts about the unification generally, but they do not apply here. I'll reply to [[#Installation template]] asap. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 21:00, 2 April 2014 (UTC)<br />
<br />
::::Ah yes, of course here I was talking only about the "Post-installation" merge, I should have written "''this'' merge proposal", not "''the''". I've marked both sections for merging: let's wait until this Saturday 12:00 UTC for any objections, I don't think there's a reason to delay this change further. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 10:22, 3 April 2014 (UTC)<br />
<br />
:I suppose after redirecting [[Beginners' guide/Post-installation]] to [[General recommendations]] it won't make any more sense to provide a multi-page version of the BG, i.e. I propose to merge [[Beginners' guide/Preparation]] and [[Beginners' guide/Installation]] back to [[Beginners' guide]]. Some adjustments will need to be done, like fixing any articles that currently link to both subpages and deleting [[Template:Beginners' guide navigation]]. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 00:34, 5 April 2014 (UTC)<br />
<br />
::Well, the merge outlined above is now done: I'll soon complete the final merge to [[Beginners' guide]] unless reasonable opposing arguments are stated here. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 03:29, 12 April 2014 (UTC)<br />
<br />
:::And the final merge to [[Beginners' guide]] is complete too. [[Template:Beginners' guide navigation]] is still used by some non-English pages though, so I haven't deleted it yet. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 06:04, 21 April 2014 (UTC)<br />
<br />
:::Plus, there's [[Beginners' Guide (Slovenský)]] that's still transcluding the English articles, maybe it should just be deleted... -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 06:09, 21 April 2014 (UTC)<br />
<br />
=== Installation template ===<br />
<br />
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. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 21:18, 27 March 2014 (UTC)<br />
<br />
: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.<br />
:'''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.<br />
:'''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 [[Help:Style|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.<br />
: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 [[Help:Style|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 [https://wiki.archlinux.org/index.php?title=Talk:NetworkManager&diff=291207&oldid=285657 too] [https://wiki.archlinux.org/index.php?title=Talk:NetworkManager&diff=304473&oldid=295238 spoiled].<br />
: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!<br />
:-- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 11:16, 30 March 2014 (UTC)<br />
<br />
::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.<br />
::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.<br />
::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.<br />
::-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 03:35, 31 March 2014 (UTC)<br />
<br />
:::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.<br />
:::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.<br />
:::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.<br />
:::-- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 07:35, 7 April 2014 (UTC)<br />
<br />
::::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...<br />
::::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).<br />
::::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).<br />
::::Of course [[ArchWiki:Requests#Cleanup: installation category]] is strictly linked to all this, I'll try to get there too.<br />
::::-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 05:26, 9 April 2014 (UTC)<br />
<br />
== Blacklisting radeon module ==<br />
<br />
Installed Arch on my laptop, during pacstrap the screen went blank, pressing SPACE, CTL+C ... didn't helped only modprobe.blacklist=radeon enabled me to go through the whole installation process.<br />
My graphic card is ATI M96 aka Mobility Radeon HD 4650.<br />
I believe this info and similar problems should be added to the beginner's guide on a Installation's Issues Troubleshooting section. I believe this is important enough to dual post and separate it from the Removing "Kernel modules" talk. p.s. I may add that this is my first desktop Linux experience--[[User:Dhead|Dhead]] ([[User talk:Dhead|talk]]) 06:20, 4 March 2013 (UTC)<br />
<br />
== Newbie here offering thoughts on what could be changed in guide ==<br />
<br />
Hey everyone, I finally successfully installed arch. I know this is easy for most people, but for me it was surprisingly more than just a weekend's worth of late nights. The number one thing that I would love to propose is Archboot. I understand that this may not be eligible for the wiki since it's not an official repository. However, it did make things ridiculously easy.<br />
<br />
Apart from that there should be a section at the very beginning explaining how to troubleshoot your own problems. Learning dmesg -HLkd and journalctl -b etc were helpful tools for me. I also appreciated learning lsblk, lsmod, ls etc from the various articles, but a quick over view of these helpful commands on this page would help newbies like myself.<br />
<br />
Also some of the methods described can be done in multiple ways, explaining that one version of live USB / Archboot uses iw instead of iwconfig or iwlist etc is not helpful if the user is confused about whether/how they can still use the old methods and how to check which they have loaded. I finally figured all this stuff out on my own (which I probably should've! no hard feelings at all).<br />
<br />
And lastly, the surprisingly tricky bit about "mounting" partitions that do not belong to you on a dual boot system. Ultimately for me what ended up working was knowing which file systems the others could read (esp in a UEFI system). These things can't just be "linked" to because even the pages linked to don't have the information. I got quite a bit of help from friends and google.<br />
<br />
Just wanted to lend my first time experience. I personally was installing on a macbook air, so perhaps this might be better suited for that discussion page. However, I can honestly say that most of it can be merged together with this page. I barely (and I mean barely.) deviated from the usual archboot install for a mac. And I did it three times to make sure it was do-able.<br />
<br />
Considering the archboot is basically the live usb wrapped in a gui (I believe?) it probably means that the two would've been quite similar for installing on a mba, and thus for macs in general. (The issues of xorg, wifi, etc, are real problems for macbooks, but I meant the general install should not require two wiki pages) [[User:Victoroux|Victoroux]] ([[User talk:Victoroux|talk]]) 14:01, 7 June 2013 (UTC)<br />
<br />
: Sorry! Just reading over again, and realizing that I could've saved a tonne of time if I knew the problem of "a bunch of white letters clustered on my screen" was an error I could check. It usually happened when the firmware didn't support something (in my case) but telling the user what he can do when this happens helps ease the wiki hopping. I finally, finally figured out how to debug most of my own problems and I think that is the number one thing this guide should do. No offense, but it would also lessen the load on the "newbie corner" on the forums (not that I know it's loaded or not, but less is better, right?). That way no matter what's written in the guide, if it's incorrect or leads to a bad result, the user can figure out why and what to do.. [[User:Victoroux|Victoroux]] ([[User talk:Victoroux|talk]]) 14:05, 7 June 2013 (UTC)<br />
<br />
:: Another [[Keyboard_Shortcuts|useful article]] that could be mentioned (rebooting from black screens, yay!) [[User:Victoroux|Victoroux]] ([[User talk:Victoroux|talk]]) 00:27, 8 June 2013 (UTC)<br />
<br />
::: I'd also like to mention [[Archboot]], if only as a [[Help:Style#Notes.2C_Warnings.2C_Tips|Tip]]. Any objections? --[[User:Alad|Alad]] ([[User talk:Alad|talk]]) 03:18, 14 June 2014 (UTC)<br />
<br />
::: See [https://wiki.archlinux.org/index.php?title=Beginners%27_guide&diff=321625&oldid=321200]. --[[User:Alad|Alad]] ([[User talk:Alad|talk]]) 11:02, 26 June 2014 (UTC)<br />
<br />
:::Regarding your second point, [[General troubleshooting]] is in Related articles - it could be expanded there. --[[User:Alad|Alad]] ([[User talk:Alad|talk]]) 14:25, 2 July 2014 (UTC)<br />
<br />
== remove gdisk instructions for install medium 2013-11 ==<br />
<br />
{{ic|fdisk}} now has GPT support, this means that both MBR and GPT disks can now be formatted with {{ic|fdisk}}. Does anyone object to removing {{ic|gdisk}} instructions from this guide when the new image is released?<br />
--[[User:Lonaowna|Lonaowna]] ([[User talk:Lonaowna|talk]]) 09:34, 25 October 2013 (UTC)<br />
<br />
:No, I strongly object. util-linux fdisk's GPT support is beta/experimental and it does not offer full set of GPT manipulation features that gdisk supports. And Rod Smith (srs5694) does an amazing job of maintaining gdisk upstream and also helps users in the forums and contributes to the wiki. You can maybe add info about util-linux fdisk's GPT support, but alone with mentioning clearly its limitations viz-a-viz gdisk. Even if fdisk gains full GPT support, gdisk is not going anywhere and its more mature. -- [[User:The.ridikulus.rat|Keshav Padram Amburay]] ([[User talk:The.ridikulus.rat|talk]]) 09:51, 25 October 2013 (UTC)<br />
<br />
::Okay, I thought it was classified as 'stable' now, but if it isn't, we should indeed keep gdisk. In the future however, I would like to move to a one-partioner because it would be a lot cleaner (the current 'partitioning' section is a mess). Thanks for the reply! --[[User:Lonaowna|Lonaowna]] ([[User talk:Lonaowna|talk]]) 06:38, 27 October 2013 (UTC)<br />
<br />
== For UEFI users: they should install dosfstools ==<br />
<br />
Shouldn't we tell UEFI users to additionally install dosfstools? Otherwise fsck.fat fails everytime they boot and shutdown.<br />
<br />
:You are right, we should. I have opened a bug report ({{bug|38076}}) to request it being added to the ''base'' group, so it will be automatically installed during the {{ic|pacstrap}} command. In the meantime, I'll look for a nice spot to add it to this guide. --[[User:Lonaowna|Lonaowna]] ([[User talk:Lonaowna|talk]]) 08:37, 15 June 2014 (UTC)<br />
<br />
== Additional Clarification ==<br />
Guide may benefit from some (admittedly obvious) clarifications and streamlining. For example:<br />
<br />
* Make it clear that font / keyboard / network configuration is at first for the install media, and not the system to be installed (e.g. this can be done by sectioning the guide)<br />
<br />
* dhcpcd should work right off the bat for wired connections; where this is so, add a line to skip to the next relevant section. A package like NetworkManager is also a nice and easy way to set up networking for installed systems. This would likely be preferable for newer users than being buried under reams of complex commands for networking.<br />
<br />
* Recommended to add base-devel as an option to the pacstrap command, and not just base.<br />
<br />
: I second the base-devel suggestion: for example, fakeroot belongs to base-devel, not devel, and without fakeroot, checkupdates fails silently. [[User:Anatin|Anatin]] ([[User talk:Anatin|talk]]) 16:45, 4 April 2014 (UTC)<br />
<br />
== network not accessible after configure under chroot during installation process ==<br />
Hello, I encountered this issue, and repeated installation process to confirm it, while I was installing arch on an Acer aspire 722 laptop when relying wireless network access during installation. <br />
<br />
As the wireless was configured before chroot, after chroot, if configuring it again, it won't trigger errors, but the network will not be accessible. Not sure if this happens to others, but I would suggest move the "chroot configuration new installation's network" after reboot the newly installed system, instead of configuring it under chroot.<br />
<br />
[[User:Ipstone|Ipstone]] ([[User talk:Ipstone|talk]]) 20:13, 4 January 2014 (UTC)<br />
<br />
:The instruction to ''configure'' network under chroot does '''not''' mean that it should also be ''started''. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 15:04, 2 July 2014 (UTC)<br />
<br />
== service suffix ==<br />
<br />
I just undid a few of [[User:Jstjohn]]'s edits that remove {{ic|.service}} from a systemctl operation.<br />
<br />
I think we should include these suffixes to show the beginning users that there are other things than services that can be managed by systemctl. Besides that, I think we should always include the unit type in this wiki, as there are cases where there is a {{ic|foo.service}} and a (for example) {{ic|foo.socket}} where not showing it can be confusing.<br />
<br />
Further more, I cannot find any documentation about what is actually done when the unit type is excluded. I THINK that it defaults to {{ic|.service}} but I'm not sure what happens when there isn't a {{ic|.service}} or there are multiple types.<br />
<br />
Thoughts? Maybe the outcome of this discussion could be included in [[Help:Style#Daemon operations]]. --[[User:Lonaowna|Lonaowna]] ([[User talk:Lonaowna|talk]]) 09:20, 15 January 2014 (UTC)<br />
<br />
:+1 for ''always'' using the {{ic|.service}} suffix ''everywhere'' on this wiki. There are many other things that can be shortened: instead of {{ic|ip link show eth0}} you can write {{ic|ip li sh eth0}} etc. Many command line utilities and libraries (e.g. Python [http://docs.python.org/dev/library/argparse.html argparse]) behave this way, I'd even say that it's a standard behaviour. Unfortunately in documentation it leads to inconsistency and bad readability. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 18:05, 31 January 2014 (UTC)<br />
<br />
::Well, consistency is always a good quality for documentation, and, between the two options, I'm also for always showing the suffix. About [[Help:Style#Daemon operations]] the problem is a little different though, as it forbids systemctl examples in the first place, except for the Beginners' Guide, so I'd say it's time to make a decision in [[Help_talk:Style#Daemons_and_modules]] about the whole wording to officially suggest in these cases. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 04:30, 2 February 2014 (UTC)<br />
<br />
== Establish an Internet Connection --> Wireless ==<br />
<br />
hey all, i am following through the beginners guide (https://wiki.archlinux.org/index.php/beginners%27_guide) and I think that I found an error in the wireless section. (I am fairly new to netctl, but found this post which is what I am basing my "error" off of : https://bbs.archlinux.org/viewtopic.php?pid=1272780#p1272780 ) The guide has the user bring the interface up, then run wifi-menu to connect to the network. According to the post netctl will not attempt to connect while the interface is up. This is how my device behaved as well. It failed to connect multiple times, to multiple networks with different security, until I brought the interface down, and then it connected. If someone could change the guide to reflect that particular quirk, it may help other beginners. Thanks!<br />
<br />
[[User:Jlmarks|Jlmarks]] ([[User talk:Jlmarks|talk]]) 06:00, 6 May 2014 (UTC)<br />
<br />
:I can confirm this, and the same behaviour is reported in [https://bbs.archlinux.org/viewtopic.php?id=181107] and [https://bbs.archlinux.org/viewtopic.php?id=162582].<br />
:I've [https://wiki.archlinux.org/index.php?title=Beginners%27_guide&diff=313803&oldid=313429 updated] the guide (and sorry for the crazy typo in the edit summary, "binr" was supposed to be "bring" :P ), but this would require further investigation, it may be a bug in netctl that has been introduced in a recent release (e.g. test with older ISOs), and in that case it should be reported.<br />
:-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 06:29, 7 May 2014 (UTC)<br />
<br />
::''netctl'' never touches an interface that is already up, I think this is by design (it's certainly not a new behaviour). -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 15:07, 2 July 2014 (UTC)<br />
<br />
== Accuracy ==<br />
Wrong/inaccurate things that needs to be fixed:<br />
* GPT is *NOT* a replacement for MBR. MBR can contain one of several different types of partition tables, including (part of) GPT. [[User:Mr.Elendig|Mr.Elendig]] ([[User talk:Mr.Elendig|talk]]) 10:54, 17 May 2014 (UTC)<br />
<br />
::Are there references other than Wikipedia ([[wikipedia:Master Boot Record]] and [[wikipedia:GUID Partition Table]])? Btw, these Wikipedia articles support the current versions of ArchWiki articles ([[Master Boot Record]] and [[GUID Partition Table]]). UEFI (including GPT) is certainly not a replacement for MBR ''only'', but when used on BIOS systems, GPT ''is'' a replacement for MBR (GPT is too large to fit into the first 512B of the disk, so the "MBR part" is ''completely'' modified to recognize GPT, making it backward compatible -- see [[wikipedia:GUID Partition Table#Legacy MBR (LBA 0)]]).<br />
::Please clarify what you meant, preferably backed up by external references.<br />
::-- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 11:31, 20 May 2014 (UTC)<br />
<br />
== base-devel ==<br />
<br />
This change re-introduced ''base-devel'' in the pacstrap example: [https://wiki.archlinux.org/index.php?title=Beginners%27_guide&diff=next&oldid=314669]. As [https://wiki.archlinux.org/index.php?title=ArchWiki:Reports&curid=13008&diff=316454&oldid=315440 reported] by [[User:Karol]], the same edit was reverted one year ago: [https://wiki.archlinux.org/index.php?title=Beginners%27_guide&diff=262822&oldid=262782].<br />
<br />
''base-devel'' is already mentioned in the instructions above, I think users should be able to understand that they can pass it to pacstrap if we remove it again from the example, but the opposite works the same, i.e. users should be able to understand that they can pass only ''base'' to pacstrap if we leave ''base-devel'' in the example.<br />
<br />
Now, this is the Beginners' guide, so maybe we could just leave it this time to prevent beginners from asking for help on the bbs or the ml when they try to install AUR packages without reading the [[AUR]] article, also considering that on [[Installation guide]] we correctly don't mention ''base-devel'' at all (it's mentioned where really needed, e.g. [[ABS]] and [[AUR]])?<br />
<br />
-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 01:25, 24 May 2014 (UTC)<br />
<br />
:See also [[Talk:Installation guide#base is redundant in pacstrap command]]. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 15:39, 2 July 2014 (UTC)<br />
<br />
== gummiboot instructions are confusing? ==<br />
<br />
The gummiboot config paths (inside the ''initrd'' and ''linux'' options) are not the same for the [[gummiboot]] guide and this guide. Also, the [[EFISTUB]] tutorial specifies different paths to copy that make both of the config paths not work.<br />
<br />
Should the user be responsible for it or should it be changed to this:<br />
<br />
linux EFI/arch/vmlinuz-arch.efi<br />
initrd EFI/arch/initramfs-arch.img<br />
<br />
--[[User:Axo-Tak|Axo-Tak]] ([[User talk:Axo-Tak|talk]]) 10:05, 28 September 2014 (UTC)<br />
<br />
:Thanks for reporting! Someone changed the paths just before your comment. I think everything should be in order now. Please let us know if you find that something doesn't work.<br />
:--[[User:Lonaowna|Lonaowna]] ([[User talk:Lonaowna|talk]]) 09:30, 5 October 2014 (UTC)<br />
<br />
== <s>What next ?</s> ==<br />
<br />
I found this a really helpful guide. However, as a beginner-to-Arch, I found that the next stages were much harder to follow. In particular, there are a lot of choices to make, and it's not always clear what do do. May I suggest that a "beginners's guide to setting up a complete desktop/laptop system" would be very helpful. I imagine that such a guide would have two aims:<br />
* Help the user install a full system with reasonable defaults (the end-result being something like a newly-installed Xubuntu/Kubuntu machine).<br />
* Document how this works, so that users can understand the process, and make their own decisions. <br />
This targets a user who wants to ''understand'' how the system works, but not (at least at first) to have to ''decide'' every single step. Thanks for your time and consideration.<br />
--[[User:RichardNeill|RichardNeill]] ([[User talk:RichardNeill|talk]]) 12:29, 4 October 2014 (UTC)<br />
<br />
:There is [[General recommendations]] (linked from [[Beginners' guide#Post-installation]] section), which summarizes topics commonly encountered after installation. As for creating a "beginners' guide to setting up a complete desktop/laptop system", there are many [[desktop environments]] and the user has to make the choice at some point. Not to mention that making choice for the user is against [[The Arch Way]]. The installation instructions for desktop environments are covered on separate pages, such as [[KDE]] or [[GNOME]]. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 13:44, 4 October 2014 (UTC)<br />
<br />
:: I think a good idea is to make [[General recommendations]] link more conspicuous. Now in that section there are a lot of text and three links to the same article (I think it's reduntant). We can use less text and one link instead of three, so that it will be easier for beginners to understand, that [[General recommendations]] is a recommended continuation of [[Beginners' guide]] article -- [[User:Kycok|Kycok]] ([[User talk:Kycok|talk]]) 06:37, 6 October 2014 (UTC)<br />
<br />
:::Well, that "lot of text" is not so useless IMHO... Maybe on the redundancy of the links to [[General recommendations]] you're right, but how would you simplify that section without losing clarity nor any important information? Maybe you can post a draft here?<br />
:::As an alternative approach, I'll just throw in this idea I've had for a while to rename [[General recommendations]] to [[Post-installation orientation]] or similar (maybe somebody can find a better word than "orientation"), what do you think?<br />
:::-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 12:53, 7 October 2014 (UTC)<br />
<br />
:::: Text may look like this:<br />
<br />
::::: Your new Arch Linux base system is now a functional GNU/Linux environment ready to be built into whatever you wish or require for your purposes. You are now ''strongly'' advised to read [[General recommendations]] article, especially first two sections. Other sections provide post-installation tutorials like setting up a graphical user interface, sound or a touchpad.<br />
<br />
::::: For a list of applications that may be of interest, see [[List of applications]].<br />
<br />
:::: Name of article is good, because that info is useful not only after installation.<br />
:::: -- [[User:Kycok|Kycok]] ([[User talk:Kycok|talk]]) 15:44, 7 October 2014 (UTC)<br />
<br />
:::::I see, I like it, you can merge it but with some fixes to the first paragraph (I've marked them in '''bold''' below) to make it clearer :)<br />
<br />
:::::: Your new Arch Linux base system is now a functional GNU/Linux environment ready to be built into whatever you wish or require for your purposes. You are now ''strongly'' advised to read '''the''' [[General recommendations]] article, especially '''the''' first two sections. '''Its''' other sections provide post-installation tutorials like setting up a graphical user interface, sound or a touchpad.<br />
<br />
:::::-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 02:31, 8 October 2014 (UTC)<br />
<br />
:::::: Done, I'll close it. I've also added "'''links to''' post-installation tutorials ...". If anybody wants to talk about article's name for [[General recommendations]], please use corresponding talk page -- [[User:Kycok|Kycok]] ([[User talk:Kycok|talk]]) 08:44, 8 October 2014 (UTC)<br />
<br />
== Gummiboot instructions are out of order. ==<br />
<br />
I'm not certain if this is the same issue as the heading "gummiboot instructions are confusing?", but I encountered this using the Beginner's guide. In "2.4 Mount the partitions", it mentions that you should mount the ESP at /boot. But then in "2.8 Chroot and configure the base system", the root is changed to the new system's mountpoint, and /boot no longer refers to the mounted ESP partition (because this was mounted in the live installation CD, in zsh). When in "2.12.2 For UEFI motherboards" I run the gummiboot install command, it errors saying that it is not a fat32 partition. Furthermore, I'm not sure if I need to actually have the initramfs files that were made during pacstrap in the actual ESP since they were installed to /boot. (My thought is they should be, because the assumption was that the ESP has actually been mounted on /boot since before pacstrap was run.) <br />
<br />
I'm not certain what to do. (I'm new, this is my first time going through this guide.) Could someone please review this? Or perhaps I made a mistake somewhere...?<br />
<br />
[[User:Tmarks|Tmarks]] ([[User talk:Tmarks|talk]]) 14:23, 11 October 2014 (UTC)</div>Tmarkshttps://wiki.archlinux.org/index.php?title=Talk:Beginners%27_guide&diff=339699Talk:Beginners' guide2014-10-11T14:23:07Z<p>Tmarks: /* Gummiboot instructions are out of order. */ new section</p>
<hr />
<div>== Unification ==<br />
=== A single, unified official install guide ===<br />
<br />
{{Note|This is based on talk/consensus in #archlinux. The official [[Installation Guide]] page is going to be expanded (or this guide could be protected, cleaned up and replace it - either works, that could be decided here).}}<br />
<br />
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.<br />
<br />
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.<br />
<br />
-- [[User:Thestinger|thestinger]] ([[User talk:Thestinger|talk]]) 21:52, 28 October 2012 (UTC)<br />
<br />
:Yes, the ISO comes with a browser ({{Pkg|elinks}}), 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).<br />
<br />
No need to create a section for this, just reminding that the unification would affect {{Bug|36111}}. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 06:57, 18 August 2013 (UTC)<br />
<br />
=== Define scope of the guide ===<br />
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 [https://wiki.archlinux.org/index.php/Beginners%27_Guide#Time_zone setting the timezone], but the article on time [https://wiki.archlinux.org/index.php/Time#Time_standard has not]. -- [[User:Karol|Karol]] ([[User talk:Karol|talk]]) 09:56, 30 October 2012 (UTC)<br />
: 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:<br />
: # Improve [[Help:Reading]]. Add some guide about Navigation, Searching, Category and Table of Contents. So users can reach the information they want more easily.<br />
: # Reduce long duplication texts. The two network configuration part is a candicate. -- [[User:Fengchao|Fengchao]] ([[User talk:Fengchao|talk]]) 07:46, 31 October 2012 (UTC)<br />
: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. [[User:Thestinger|thestinger]] ([[User talk:Thestinger|talk]]) 17:28, 3 November 2012 (UTC)<br />
<br />
::''[This comment was pasted here from a different, now deleted discussion]''<br />
:: 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. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 15:40, 19 September 2012 (UTC)<br />
<br />
=== Unification Status? ===<br />
Hello,<br />
<br />
Is there any forward motion on unifying or cleaning up the Installation Guides? I would like to lend my hand if or when I earn that ability.<br />
<br />
Both my fiancee and I have recently completed installs of Arch Linux and found ourselves hopping back and forth between the official installation guide and this Beginners Guide. Short of unification, synchronizing the steps would be a huge boon for those that utilize the resources in a similar manner.<br />
<br />
Cheers,<br />
[[User:AdamT|AdamT]] ([[User talk:AdamT|talk]]) 03:35, 24 July 2013 (UTC)<br />
<br />
:While it's more work and kind of a mess sometimes with 2 Guides, if those 2 are well maintained it has the advantage to serve distinct target groups well. If you where to merge into one, i fear you'd either annoy the expierienced Users with unnecessary fluff, or if you cut too much info out of it you'd leave the newbies with open questions. <br />
:Another system would be, have one guide, and on specific topics links to article which will explain those well. But then you would have to but all the verbose-newbiew "explain everything" information into those subarticles. I don't think it would be a better system.<br />
:One thing which i don't like about current state of the Beginners Guide, in some places there is some quite advanced info/adviced included which is only relevant in niche-scenarious. I think those should be moved into the specialized articles on a case by case basis.<br />
:What do you mean when you say "synchronizing the steps"? How would this look like?<br />
:[[User:Bwid|Bwid]] ([[User talk:Bwid|talk]]) 08:22, 24 July 2013 (UTC)<br />
::Hi Bwid,<br />
::I should have clarified with regards to synchronizing the steps between the [[Beginners' Guide]] and the official [[Installation Guide]]. Simply put, the Beginners' Guide completes the installation with steps ordered differently than the Installation Guide.<br />
::Examples:<br />
::*Connecting to the internet<br />
::**Beginners' Guide Section 2.2<br />
::**Installation Guide Section 2.5<br />
::*Configure the System<br />
::**Installation Guide Section 2.7<br />
::**Beginner's Guide Section 2.8<br />
::***Under which the steps are differently ordered compared to the installation guide.<br />
::Going back over this, it does seem a little trite, but if we are going to maintain two separate guides keeping them as close as possible in terms of process seems to be the simpler choice. I am not saying they need to have the same section numbers (though where feasible, that would be ideal I should think), just flow in the same order from start to finish.<br />
::There is something that strikes me as being distinctly not in keeping with [[The Arch Way]] with regards to keeping two separate guides. With that said, assuming for a moment that two guides are a necessary evil, it further seems to go against simplicity by keeping redundant information in the Beginners' Guide that could otherwise be put (and should be put or at least duplicated in my view) in the subject specific Arch Wiki articles so that people that are not just installing, or that may not consider themselves beginners might benefit from the information as well.<br />
::It does not need to be novice user centric, it does not need to be verbose. The sub-articles just need to provide the information that is necessary to properly address a given subject with regards to Arch Linux, which is the point of the subject specific articles as it is. Comprehensiveness is listed as a goal for the Arch Wiki so this should not be something that is feared ([[ArchWiki:About#Comprehensive]]).<br />
::This linking to relevant articles is exactly what the official Installation Guide does, and finding subject specific articles is a skill needed post-install for anyone that continues to use Arch Linux.<br />
::Anyway, I do not intend to talk this to death or to become hyperbolic, this just seemed to have fizzled and I was curious as to its current state. If people are happy with the current state of things regarding the installation guides that works for me I shall focus on other articles! : )<br />
::Cheers!<br />
::[[User:AdamT|AdamT]] ([[User talk:AdamT|talk]]) 18:20, 24 July 2013 (UTC)<br />
:::Actually i think its good that you brought the topic up again. I was wondering along the same lines a while again. Is it worth it spending time working on restructuring the guide when the the thing might be done away with soon? Also don't take my rationalization of the 2 Guides as some sort of common opinion, i am sure there are many who agree that the Beginners Guide shouldnt duplicate Install guide, and even I am not sure about if what I wrote above is true. If the decission is that the BG should be repurposed, and instead the articles which are linked from IG improved then i would be fine with it.<br />
:::[[User:Bwid|Bwid]] ([[User talk:Bwid|talk]]) 19:02, 24 July 2013 (UTC)<br />
::::Technically yes, having only one slim installation guide that links to specific articles is the solution supported by [[User:thestinger|thestinger]] and [[User:Kynikos|me]] (although with slightly different opinions on some things like protection of the article), and IIRC I've never read a word against the idea from other admins.<br />
::::IMO the only big problem that's still holding us back is that we're playing with what's arguably the most visited article of the wiki, which is sometimes seen as kind of a trademark from outside, so everybody (including me) is hesitant about making the final decision that will definitively kill it. Maybe, and I say ''maybe'', we should discuss this on the forums, where we would get many more responses, although a big part of them would probably be against the merge, as many new users do like having as much information as possible in one article without having to click on links. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 13:02, 25 July 2013 (UTC)<br />
:::::Bwid & Kynikos,<br />
:::::I appreciate both of your well reasoned responses. If the time is worth investing, perhaps putting together a third, unified option and then presenting the three on the forums (or however the admins would like) would provide a concise comparison which the community at large could form an educated opinion and decision from?<br />
:::::[[User:AdamT|AdamT]] ([[User talk:AdamT|talk]]) 21:47, 25 July 2013 (UTC)<br />
::::::Sorry I'm not following, what would be the third option? :) -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 04:54, 27 July 2013 (UTC)<br />
:::::::Kynikos,<br />
:::::::No worries. The third option would be a "unified guide" that we could create without removing the existing two (the official Installation Guide and the Beginners' Guide) so that a direct comparison could be made between the existing guides and our proposed unified guide. This would allow the admins to bring the guides before the greater community for a vote on which to use (the current two guides or a singular unified replacement). The risk with this plan is the potential for wasted time in creating a guide that may not ultimately be used. We should also probably commit to deleting the third guide if the community votes against it so as not to make the current situation worse with a third unofficial guide. :)<br />
:::::::I hope this makes my idea clearer.<br />
:::::::Take care,<br />
:::::::[[User:AdamT|AdamT]] ([[User talk:AdamT|talk]]) 18:55, 27 July 2013 (UTC)<br />
::::::::I don't think this third option is feasible without affecting the other two guides, in fact the big part of this whole unification is moving content from the Beginners' Guide to the various specific articles, and the third option wouldn't make sense if we don't do that. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 11:14, 29 July 2013 (UTC)<br />
<br />
====The transclusion way====<br />
I agree with the idea to create a guide for all users. For newbies, the fastest way to achieve the installation step should be written explicitly. Alternative/advanced ways {{ic|(e.g. other bootloaders instead of the default proposed gummiboot for uefi bootloader)}} should be put in a dedicated article {{ic|(to take the same example, the [[Bootloader]] article --> this article could even integrate the introduction section of grub for example. --> We will have recursive inclusions)}}.<br />
<br />
In order to avoid duplication and avoid too much maintenance efforts, we could use the [http://www.mediawiki.org/wiki/Transclusion MediaWiki's transclusion method], which embeds section of internal wiki pages into the current one ([https://www.mediawiki.org/wiki/Extension:Labeled_Section_Transclusion a dedicated extension exists to provide even more advanced inclusions possibilities]). In that way, we maintain all the dedicated pages and include some of their sections to the unified install guide. Pay attention to don't broke the links when editing the dedicated articles. In that way, we will satisfy both kind of users: the advanced ones and the newbies.<br />
<br />
* The advanced ones will check the advanced pages when skimming the unified installation guide. For these users the guide will be like a memento (the current [[Installation Guide]] is thus not needed any more). <br />
* For newbies, it will be a beginner guide which will offer the availability to learn further by reading the linked pages.<br />
<br />
{{bc|<br />
Example:<br />
<br />
Install guide<br />
<br />
5. Add a bootloader<br />
<Include introduction section of the bootloader article: what is a bootloader><br />
<br />
Use the recommended one for UEFI:<br />
<Include standard/easy install section gummiboot install><br />
<br />
etc.<br />
}}<br />
<br />
-- [[User:wget|wget]] ([[User talk:wget|talk]]) 17:57, 4 August 2013 (UTC)<br />
<br />
:Um I thought of this possibility myself a while ago, but then discarded it because it would make maintenance even more difficult, as when editing one of the transcluded articles it should always be taken into account any consequence on the "long" article; in the end, it looks too complicated to me. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 11:50, 5 August 2013 (UTC)<br />
<br />
::This is the reason I wrote "Pay attention to don't broke the links when editing the dedicated articles.". But I think applying this method is the best way to avoid duplication efforts. Take the following example. A guy: "It would be great if we add this new useful tool to establish a wi-fi connection to the beginner guide", another guy checking/watching the network page won't be informed and cannot bring its experience as he won't be informed about these changes written in the install guide.<br />
<br />
::If you're a developer you know what I mean when I say page inclusion is the BEST way to avoid duplication ;-)<br />
::- [[User:wget|wget]] ([[User talk:wget|talk]]) 12:52, 5 August 2013 (UTC)<br />
<br />
:::One big problem I foresee with this method is that we still should maintain two separate installation guides: they should contain the same instructions, but one should contain links to the relevant articles, while the other should transclude the needed article sections; this means this method wouldn't avoid duplication completely :) I still think the "links" way is the simplest and most efficient. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 14:27, 6 August 2013 (UTC)<br />
:::: +1 for links. Based on my old experience, inclusion increase maintenance efforts, you need to consider both pages when editing. And what is worse, it make it harder for new users to contribute because change in one place may influence another page they do not know well. Let us keep it simple :) -- [[User:Fengchao|Fengchao]] ([[User talk:Fengchao|talk]]) 13:23, 11 August 2013 (UTC)<br />
<br />
:Please note that it is crucial that the document aimed at beginners (whether a separate article or not) direct UEFI users for whom gummiboot fails to alternative boot methods. I do not have in mind cases where a complex configuration requires something else but, rather, cases in which the user's firmware will not work with this method. One case is that in which the firmware fails with any method relying on EFISTUB. This is not the standard case but it is not uncommon either. Moreover, all UEFI users should be aware of this because firmware which boots the EFISTUB with this kernel may easily refuse to do so with the next. Any user using UEFI to boot needs to be aware of this possibility and of where to look for work-arounds if it they are hit by the bug(s) at some point. (Almost certainly multiple bugs at work here.) I am reiterating this because the original discussion (complete with forum links) has been removed as closed. That's fine but I worry that people unaware of those issues may easily streamline the new version of the guide in a way which recreates the problem with the same results: lots of confused beginners on the forums, often being directed back to a version of the guide which fails to point them in any useful direction. --[[User:Margali|cfr]] ([[User talk:Margali|talk]]) 23:35, 22 September 2013 (UTC)<br />
<br />
=== Merge two network config sections ===<br />
In my opinion the [[Beginner%27s_Guide#Configure_the_network|network configuration section]] is no longer correct and it should be replaced with the correct section from [[Configuring_Network#Configure_the_IP_address|this page]]. At least, the static IP configuration section does not work for me. This is probably caused by the switch to [[systemd]].<br />
--[[User:Doru001|Doru001]] ([[User talk:Doru001|talk]]) 16:49, 29 January 2013 (UTC)<br />
<br />
Most of this section is a repeat of info already presented earlier in the guide (most notably in [[Beginners'_Guide#Configure_Network_.28Netinstall.29|3.1.1]]).<br />
<br />
I understand that directing users to [[Beginners'_Guide#Configure_Network_.28Netinstall.29|3.1.1]] when they've already got a system up and running isn't that great of an idea since they are no longer in the live environment and some things are different (but not much!), but surely something can be done to reduce the redunancy (especially on the [[Beginners'_Guide#Wireless_LAN|4.1.2 Wireless LAN]] section, which is basically a 1:1 copy of [[Beginners'_Guide#Wireless_Quickstart_For_the_Live_Environment|3.1.1.2]]) [[User:Xgamer99|Xgamer99]] 19:49, 8 January 2011 (EST)<br />
:Went ahead and made the edit, as I can't see anything wrong with it. Please let me know if you disagree. However, I still believe that 4.1 should be re-worked and merged with 3.1.1, and just have 4.1 direct users to it. The only thing that would need to be added is the Proxy settings and manual wired connection (installer handles wired connections flawlessly, so manual activation isn't covered in 3.1.1). [[User:Xgamer99|Xgamer99]] 04:00, 9 January 2011 (EST)<br />
:: Reopen this discuss. Those two network configuration section still exist. They should be merged. -- [[User:Fengchao|Fengchao]] ([[User talk:Fengchao|talk]]) 10:16, 1 August 2012 (UTC)<br />
::: There are [[Beginners%27_Guide#Establish_an_internet_connection]] and [[Beginners%27_Guide#Configure_the_network]] sections. Though they are not 1:1 copy, I agree that they should be merged. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 14:34, 4 August 2013 (UTC)<br />
::::Just to make sure it is clear, there are two sections because one configures the network in the live environment, the other does it in the chroot environment; for example in the first section it's not needed to enable services or netctl profiles. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 11:43, 5 August 2013 (UTC)<br />
:::I disagree, they should not be merged. The first one is just a quick and dirty one-time setup. (As it should be.) The second one is about how to setup a network manager that provides a persistent connection. I think that merging these two will lead to more confusion. (I've already seen lots of people who do not understand that the network has to be configured twice; I think that we should explain the difference more clearly.) --[[User:Lonaowna|Lonaowna]] ([[User talk:Lonaowna|talk]]) 11:53, 5 August 2013 (UTC)<br />
:::: What about put this into another form: Merge common parts into [[Network configuration]] and leave just a link here. -- [[User:Fengchao|Fengchao]] ([[User talk:Fengchao|talk]]) 13:25, 11 August 2013 (UTC)<br />
<br />
=== Plan ===<br />
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. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 06:44, 18 August 2013 (UTC)<br />
<br />
Here is a list of sections that should be merged. Feel free to expand, comment in [[#Comments]]. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 18:26, 31 August 2013 (UTC)<br />
<br />
* <s>[[Beginners' Guide#Graphical User Interface]]<br />
** [[Beginners' Guide#Install X]] - merge into [[Xorg#Installation]], leave only the description of X and link to the target<br />
** [[Beginners' Guide#Install a video driver]] - merge into [[Xorg#Driver installation]], leave only the note in the beginning and link to the target<br />
** [[Beginners' Guide#Install input drivers]] - merge into [[Xorg#Input devices]], leave only note ''in most cases, installing input drivers is not needed'' and links to the target and [[Touchpad Synaptics]]<br />
** [[Beginners' Guide#Test X]] - not sure about this, I'd leave it as it is optional</s><br />
<br />
==== General problems ====<br />
<br />
* ''timedatectl'', ''hostnamectl'', ''localectl'' etc. won't work from inside a chroot, so manual method of configuration is required. This could be avoided by having users reboot before configuring this stuff (time, hostname, etc. aren't critical at all). (mentioned in [[#Define scope of the guide]] by [[User:Thestinger]])<br />
<br />
==== Comments ====<br />
<br />
I think a first step we could take relatively easily would be to completely merge [[Beginners' guide/Post-installation]] and [[Installation guide#Post-installation]] into [[General recommendations]] and [[Xorg]] (following the list above in [[#Plan]]). -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 03:35, 31 March 2014 (UTC)<br />
<br />
:The sections in [[General recommendations]] are sorted alphabetically, however for the merging it would be useful to reorder them by "usefulness" or "importance" - don't know how to measure it, but [[General recommendations#Appearance]] would certainly be the last... -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 06:25, 31 March 2014 (UTC)<br />
<br />
::Of course reordering the sections by importance would be essential. Can I assume you agree with the merge proposal then? -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 00:01, 2 April 2014 (UTC)<br />
<br />
:::Indeed I do, [[General recommendations]] is already much more useful than [[Beginners' guide/Post-installation]], it makes sense to keep things in one place and merge ''this section''. I still have some doubts about the unification generally, but they do not apply here. I'll reply to [[#Installation template]] asap. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 21:00, 2 April 2014 (UTC)<br />
<br />
::::Ah yes, of course here I was talking only about the "Post-installation" merge, I should have written "''this'' merge proposal", not "''the''". I've marked both sections for merging: let's wait until this Saturday 12:00 UTC for any objections, I don't think there's a reason to delay this change further. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 10:22, 3 April 2014 (UTC)<br />
<br />
:I suppose after redirecting [[Beginners' guide/Post-installation]] to [[General recommendations]] it won't make any more sense to provide a multi-page version of the BG, i.e. I propose to merge [[Beginners' guide/Preparation]] and [[Beginners' guide/Installation]] back to [[Beginners' guide]]. Some adjustments will need to be done, like fixing any articles that currently link to both subpages and deleting [[Template:Beginners' guide navigation]]. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 00:34, 5 April 2014 (UTC)<br />
<br />
::Well, the merge outlined above is now done: I'll soon complete the final merge to [[Beginners' guide]] unless reasonable opposing arguments are stated here. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 03:29, 12 April 2014 (UTC)<br />
<br />
:::And the final merge to [[Beginners' guide]] is complete too. [[Template:Beginners' guide navigation]] is still used by some non-English pages though, so I haven't deleted it yet. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 06:04, 21 April 2014 (UTC)<br />
<br />
:::Plus, there's [[Beginners' Guide (Slovenský)]] that's still transcluding the English articles, maybe it should just be deleted... -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 06:09, 21 April 2014 (UTC)<br />
<br />
=== Installation template ===<br />
<br />
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. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 21:18, 27 March 2014 (UTC)<br />
<br />
: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.<br />
:'''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.<br />
:'''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 [[Help:Style|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.<br />
: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 [[Help:Style|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 [https://wiki.archlinux.org/index.php?title=Talk:NetworkManager&diff=291207&oldid=285657 too] [https://wiki.archlinux.org/index.php?title=Talk:NetworkManager&diff=304473&oldid=295238 spoiled].<br />
: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!<br />
:-- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 11:16, 30 March 2014 (UTC)<br />
<br />
::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.<br />
::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.<br />
::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.<br />
::-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 03:35, 31 March 2014 (UTC)<br />
<br />
:::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.<br />
:::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.<br />
:::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.<br />
:::-- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 07:35, 7 April 2014 (UTC)<br />
<br />
::::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...<br />
::::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).<br />
::::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).<br />
::::Of course [[ArchWiki:Requests#Cleanup: installation category]] is strictly linked to all this, I'll try to get there too.<br />
::::-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 05:26, 9 April 2014 (UTC)<br />
<br />
== Blacklisting radeon module ==<br />
<br />
Installed Arch on my laptop, during pacstrap the screen went blank, pressing SPACE, CTL+C ... didn't helped only modprobe.blacklist=radeon enabled me to go through the whole installation process.<br />
My graphic card is ATI M96 aka Mobility Radeon HD 4650.<br />
I believe this info and similar problems should be added to the beginner's guide on a Installation's Issues Troubleshooting section. I believe this is important enough to dual post and separate it from the Removing "Kernel modules" talk. p.s. I may add that this is my first desktop Linux experience--[[User:Dhead|Dhead]] ([[User talk:Dhead|talk]]) 06:20, 4 March 2013 (UTC)<br />
<br />
== Newbie here offering thoughts on what could be changed in guide ==<br />
<br />
Hey everyone, I finally successfully installed arch. I know this is easy for most people, but for me it was surprisingly more than just a weekend's worth of late nights. The number one thing that I would love to propose is Archboot. I understand that this may not be eligible for the wiki since it's not an official repository. However, it did make things ridiculously easy.<br />
<br />
Apart from that there should be a section at the very beginning explaining how to troubleshoot your own problems. Learning dmesg -HLkd and journalctl -b etc were helpful tools for me. I also appreciated learning lsblk, lsmod, ls etc from the various articles, but a quick over view of these helpful commands on this page would help newbies like myself.<br />
<br />
Also some of the methods described can be done in multiple ways, explaining that one version of live USB / Archboot uses iw instead of iwconfig or iwlist etc is not helpful if the user is confused about whether/how they can still use the old methods and how to check which they have loaded. I finally figured all this stuff out on my own (which I probably should've! no hard feelings at all).<br />
<br />
And lastly, the surprisingly tricky bit about "mounting" partitions that do not belong to you on a dual boot system. Ultimately for me what ended up working was knowing which file systems the others could read (esp in a UEFI system). These things can't just be "linked" to because even the pages linked to don't have the information. I got quite a bit of help from friends and google.<br />
<br />
Just wanted to lend my first time experience. I personally was installing on a macbook air, so perhaps this might be better suited for that discussion page. However, I can honestly say that most of it can be merged together with this page. I barely (and I mean barely.) deviated from the usual archboot install for a mac. And I did it three times to make sure it was do-able.<br />
<br />
Considering the archboot is basically the live usb wrapped in a gui (I believe?) it probably means that the two would've been quite similar for installing on a mba, and thus for macs in general. (The issues of xorg, wifi, etc, are real problems for macbooks, but I meant the general install should not require two wiki pages) [[User:Victoroux|Victoroux]] ([[User talk:Victoroux|talk]]) 14:01, 7 June 2013 (UTC)<br />
<br />
: Sorry! Just reading over again, and realizing that I could've saved a tonne of time if I knew the problem of "a bunch of white letters clustered on my screen" was an error I could check. It usually happened when the firmware didn't support something (in my case) but telling the user what he can do when this happens helps ease the wiki hopping. I finally, finally figured out how to debug most of my own problems and I think that is the number one thing this guide should do. No offense, but it would also lessen the load on the "newbie corner" on the forums (not that I know it's loaded or not, but less is better, right?). That way no matter what's written in the guide, if it's incorrect or leads to a bad result, the user can figure out why and what to do.. [[User:Victoroux|Victoroux]] ([[User talk:Victoroux|talk]]) 14:05, 7 June 2013 (UTC)<br />
<br />
:: Another [[Keyboard_Shortcuts|useful article]] that could be mentioned (rebooting from black screens, yay!) [[User:Victoroux|Victoroux]] ([[User talk:Victoroux|talk]]) 00:27, 8 June 2013 (UTC)<br />
<br />
::: I'd also like to mention [[Archboot]], if only as a [[Help:Style#Notes.2C_Warnings.2C_Tips|Tip]]. Any objections? --[[User:Alad|Alad]] ([[User talk:Alad|talk]]) 03:18, 14 June 2014 (UTC)<br />
<br />
::: See [https://wiki.archlinux.org/index.php?title=Beginners%27_guide&diff=321625&oldid=321200]. --[[User:Alad|Alad]] ([[User talk:Alad|talk]]) 11:02, 26 June 2014 (UTC)<br />
<br />
:::Regarding your second point, [[General troubleshooting]] is in Related articles - it could be expanded there. --[[User:Alad|Alad]] ([[User talk:Alad|talk]]) 14:25, 2 July 2014 (UTC)<br />
<br />
== remove gdisk instructions for install medium 2013-11 ==<br />
<br />
{{ic|fdisk}} now has GPT support, this means that both MBR and GPT disks can now be formatted with {{ic|fdisk}}. Does anyone object to removing {{ic|gdisk}} instructions from this guide when the new image is released?<br />
--[[User:Lonaowna|Lonaowna]] ([[User talk:Lonaowna|talk]]) 09:34, 25 October 2013 (UTC)<br />
<br />
:No, I strongly object. util-linux fdisk's GPT support is beta/experimental and it does not offer full set of GPT manipulation features that gdisk supports. And Rod Smith (srs5694) does an amazing job of maintaining gdisk upstream and also helps users in the forums and contributes to the wiki. You can maybe add info about util-linux fdisk's GPT support, but alone with mentioning clearly its limitations viz-a-viz gdisk. Even if fdisk gains full GPT support, gdisk is not going anywhere and its more mature. -- [[User:The.ridikulus.rat|Keshav Padram Amburay]] ([[User talk:The.ridikulus.rat|talk]]) 09:51, 25 October 2013 (UTC)<br />
<br />
::Okay, I thought it was classified as 'stable' now, but if it isn't, we should indeed keep gdisk. In the future however, I would like to move to a one-partioner because it would be a lot cleaner (the current 'partitioning' section is a mess). Thanks for the reply! --[[User:Lonaowna|Lonaowna]] ([[User talk:Lonaowna|talk]]) 06:38, 27 October 2013 (UTC)<br />
<br />
== For UEFI users: they should install dosfstools ==<br />
<br />
Shouldn't we tell UEFI users to additionally install dosfstools? Otherwise fsck.fat fails everytime they boot and shutdown.<br />
<br />
:You are right, we should. I have opened a bug report ({{bug|38076}}) to request it being added to the ''base'' group, so it will be automatically installed during the {{ic|pacstrap}} command. In the meantime, I'll look for a nice spot to add it to this guide. --[[User:Lonaowna|Lonaowna]] ([[User talk:Lonaowna|talk]]) 08:37, 15 June 2014 (UTC)<br />
<br />
== Additional Clarification ==<br />
Guide may benefit from some (admittedly obvious) clarifications and streamlining. For example:<br />
<br />
* Make it clear that font / keyboard / network configuration is at first for the install media, and not the system to be installed (e.g. this can be done by sectioning the guide)<br />
<br />
* dhcpcd should work right off the bat for wired connections; where this is so, add a line to skip to the next relevant section. A package like NetworkManager is also a nice and easy way to set up networking for installed systems. This would likely be preferable for newer users than being buried under reams of complex commands for networking.<br />
<br />
* Recommended to add base-devel as an option to the pacstrap command, and not just base.<br />
<br />
: I second the base-devel suggestion: for example, fakeroot belongs to base-devel, not devel, and without fakeroot, checkupdates fails silently. [[User:Anatin|Anatin]] ([[User talk:Anatin|talk]]) 16:45, 4 April 2014 (UTC)<br />
<br />
== network not accessible after configure under chroot during installation process ==<br />
Hello, I encountered this issue, and repeated installation process to confirm it, while I was installing arch on an Acer aspire 722 laptop when relying wireless network access during installation. <br />
<br />
As the wireless was configured before chroot, after chroot, if configuring it again, it won't trigger errors, but the network will not be accessible. Not sure if this happens to others, but I would suggest move the "chroot configuration new installation's network" after reboot the newly installed system, instead of configuring it under chroot.<br />
<br />
[[User:Ipstone|Ipstone]] ([[User talk:Ipstone|talk]]) 20:13, 4 January 2014 (UTC)<br />
<br />
:The instruction to ''configure'' network under chroot does '''not''' mean that it should also be ''started''. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 15:04, 2 July 2014 (UTC)<br />
<br />
== service suffix ==<br />
<br />
I just undid a few of [[User:Jstjohn]]'s edits that remove {{ic|.service}} from a systemctl operation.<br />
<br />
I think we should include these suffixes to show the beginning users that there are other things than services that can be managed by systemctl. Besides that, I think we should always include the unit type in this wiki, as there are cases where there is a {{ic|foo.service}} and a (for example) {{ic|foo.socket}} where not showing it can be confusing.<br />
<br />
Further more, I cannot find any documentation about what is actually done when the unit type is excluded. I THINK that it defaults to {{ic|.service}} but I'm not sure what happens when there isn't a {{ic|.service}} or there are multiple types.<br />
<br />
Thoughts? Maybe the outcome of this discussion could be included in [[Help:Style#Daemon operations]]. --[[User:Lonaowna|Lonaowna]] ([[User talk:Lonaowna|talk]]) 09:20, 15 January 2014 (UTC)<br />
<br />
:+1 for ''always'' using the {{ic|.service}} suffix ''everywhere'' on this wiki. There are many other things that can be shortened: instead of {{ic|ip link show eth0}} you can write {{ic|ip li sh eth0}} etc. Many command line utilities and libraries (e.g. Python [http://docs.python.org/dev/library/argparse.html argparse]) behave this way, I'd even say that it's a standard behaviour. Unfortunately in documentation it leads to inconsistency and bad readability. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 18:05, 31 January 2014 (UTC)<br />
<br />
::Well, consistency is always a good quality for documentation, and, between the two options, I'm also for always showing the suffix. About [[Help:Style#Daemon operations]] the problem is a little different though, as it forbids systemctl examples in the first place, except for the Beginners' Guide, so I'd say it's time to make a decision in [[Help_talk:Style#Daemons_and_modules]] about the whole wording to officially suggest in these cases. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 04:30, 2 February 2014 (UTC)<br />
<br />
== Establish an Internet Connection --> Wireless ==<br />
<br />
hey all, i am following through the beginners guide (https://wiki.archlinux.org/index.php/beginners%27_guide) and I think that I found an error in the wireless section. (I am fairly new to netctl, but found this post which is what I am basing my "error" off of : https://bbs.archlinux.org/viewtopic.php?pid=1272780#p1272780 ) The guide has the user bring the interface up, then run wifi-menu to connect to the network. According to the post netctl will not attempt to connect while the interface is up. This is how my device behaved as well. It failed to connect multiple times, to multiple networks with different security, until I brought the interface down, and then it connected. If someone could change the guide to reflect that particular quirk, it may help other beginners. Thanks!<br />
<br />
[[User:Jlmarks|Jlmarks]] ([[User talk:Jlmarks|talk]]) 06:00, 6 May 2014 (UTC)<br />
<br />
:I can confirm this, and the same behaviour is reported in [https://bbs.archlinux.org/viewtopic.php?id=181107] and [https://bbs.archlinux.org/viewtopic.php?id=162582].<br />
:I've [https://wiki.archlinux.org/index.php?title=Beginners%27_guide&diff=313803&oldid=313429 updated] the guide (and sorry for the crazy typo in the edit summary, "binr" was supposed to be "bring" :P ), but this would require further investigation, it may be a bug in netctl that has been introduced in a recent release (e.g. test with older ISOs), and in that case it should be reported.<br />
:-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 06:29, 7 May 2014 (UTC)<br />
<br />
::''netctl'' never touches an interface that is already up, I think this is by design (it's certainly not a new behaviour). -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 15:07, 2 July 2014 (UTC)<br />
<br />
== Accuracy ==<br />
Wrong/inaccurate things that needs to be fixed:<br />
* GPT is *NOT* a replacement for MBR. MBR can contain one of several different types of partition tables, including (part of) GPT. [[User:Mr.Elendig|Mr.Elendig]] ([[User talk:Mr.Elendig|talk]]) 10:54, 17 May 2014 (UTC)<br />
<br />
::Are there references other than Wikipedia ([[wikipedia:Master Boot Record]] and [[wikipedia:GUID Partition Table]])? Btw, these Wikipedia articles support the current versions of ArchWiki articles ([[Master Boot Record]] and [[GUID Partition Table]]). UEFI (including GPT) is certainly not a replacement for MBR ''only'', but when used on BIOS systems, GPT ''is'' a replacement for MBR (GPT is too large to fit into the first 512B of the disk, so the "MBR part" is ''completely'' modified to recognize GPT, making it backward compatible -- see [[wikipedia:GUID Partition Table#Legacy MBR (LBA 0)]]).<br />
::Please clarify what you meant, preferably backed up by external references.<br />
::-- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 11:31, 20 May 2014 (UTC)<br />
<br />
== base-devel ==<br />
<br />
This change re-introduced ''base-devel'' in the pacstrap example: [https://wiki.archlinux.org/index.php?title=Beginners%27_guide&diff=next&oldid=314669]. As [https://wiki.archlinux.org/index.php?title=ArchWiki:Reports&curid=13008&diff=316454&oldid=315440 reported] by [[User:Karol]], the same edit was reverted one year ago: [https://wiki.archlinux.org/index.php?title=Beginners%27_guide&diff=262822&oldid=262782].<br />
<br />
''base-devel'' is already mentioned in the instructions above, I think users should be able to understand that they can pass it to pacstrap if we remove it again from the example, but the opposite works the same, i.e. users should be able to understand that they can pass only ''base'' to pacstrap if we leave ''base-devel'' in the example.<br />
<br />
Now, this is the Beginners' guide, so maybe we could just leave it this time to prevent beginners from asking for help on the bbs or the ml when they try to install AUR packages without reading the [[AUR]] article, also considering that on [[Installation guide]] we correctly don't mention ''base-devel'' at all (it's mentioned where really needed, e.g. [[ABS]] and [[AUR]])?<br />
<br />
-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 01:25, 24 May 2014 (UTC)<br />
<br />
:See also [[Talk:Installation guide#base is redundant in pacstrap command]]. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 15:39, 2 July 2014 (UTC)<br />
<br />
== gummiboot instructions are confusing? ==<br />
<br />
The gummiboot config paths (inside the ''initrd'' and ''linux'' options) are not the same for the [[gummiboot]] guide and this guide. Also, the [[EFISTUB]] tutorial specifies different paths to copy that make both of the config paths not work.<br />
<br />
Should the user be responsible for it or should it be changed to this:<br />
<br />
linux EFI/arch/vmlinuz-arch.efi<br />
initrd EFI/arch/initramfs-arch.img<br />
<br />
--[[User:Axo-Tak|Axo-Tak]] ([[User talk:Axo-Tak|talk]]) 10:05, 28 September 2014 (UTC)<br />
<br />
:Thanks for reporting! Someone changed the paths just before your comment. I think everything should be in order now. Please let us know if you find that something doesn't work.<br />
:--[[User:Lonaowna|Lonaowna]] ([[User talk:Lonaowna|talk]]) 09:30, 5 October 2014 (UTC)<br />
<br />
== <s>What next ?</s> ==<br />
<br />
I found this a really helpful guide. However, as a beginner-to-Arch, I found that the next stages were much harder to follow. In particular, there are a lot of choices to make, and it's not always clear what do do. May I suggest that a "beginners's guide to setting up a complete desktop/laptop system" would be very helpful. I imagine that such a guide would have two aims:<br />
* Help the user install a full system with reasonable defaults (the end-result being something like a newly-installed Xubuntu/Kubuntu machine).<br />
* Document how this works, so that users can understand the process, and make their own decisions. <br />
This targets a user who wants to ''understand'' how the system works, but not (at least at first) to have to ''decide'' every single step. Thanks for your time and consideration.<br />
--[[User:RichardNeill|RichardNeill]] ([[User talk:RichardNeill|talk]]) 12:29, 4 October 2014 (UTC)<br />
<br />
:There is [[General recommendations]] (linked from [[Beginners' guide#Post-installation]] section), which summarizes topics commonly encountered after installation. As for creating a "beginners' guide to setting up a complete desktop/laptop system", there are many [[desktop environments]] and the user has to make the choice at some point. Not to mention that making choice for the user is against [[The Arch Way]]. The installation instructions for desktop environments are covered on separate pages, such as [[KDE]] or [[GNOME]]. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 13:44, 4 October 2014 (UTC)<br />
<br />
:: I think a good idea is to make [[General recommendations]] link more conspicuous. Now in that section there are a lot of text and three links to the same article (I think it's reduntant). We can use less text and one link instead of three, so that it will be easier for beginners to understand, that [[General recommendations]] is a recommended continuation of [[Beginners' guide]] article -- [[User:Kycok|Kycok]] ([[User talk:Kycok|talk]]) 06:37, 6 October 2014 (UTC)<br />
<br />
:::Well, that "lot of text" is not so useless IMHO... Maybe on the redundancy of the links to [[General recommendations]] you're right, but how would you simplify that section without losing clarity nor any important information? Maybe you can post a draft here?<br />
:::As an alternative approach, I'll just throw in this idea I've had for a while to rename [[General recommendations]] to [[Post-installation orientation]] or similar (maybe somebody can find a better word than "orientation"), what do you think?<br />
:::-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 12:53, 7 October 2014 (UTC)<br />
<br />
:::: Text may look like this:<br />
<br />
::::: Your new Arch Linux base system is now a functional GNU/Linux environment ready to be built into whatever you wish or require for your purposes. You are now ''strongly'' advised to read [[General recommendations]] article, especially first two sections. Other sections provide post-installation tutorials like setting up a graphical user interface, sound or a touchpad.<br />
<br />
::::: For a list of applications that may be of interest, see [[List of applications]].<br />
<br />
:::: Name of article is good, because that info is useful not only after installation.<br />
:::: -- [[User:Kycok|Kycok]] ([[User talk:Kycok|talk]]) 15:44, 7 October 2014 (UTC)<br />
<br />
:::::I see, I like it, you can merge it but with some fixes to the first paragraph (I've marked them in '''bold''' below) to make it clearer :)<br />
<br />
:::::: Your new Arch Linux base system is now a functional GNU/Linux environment ready to be built into whatever you wish or require for your purposes. You are now ''strongly'' advised to read '''the''' [[General recommendations]] article, especially '''the''' first two sections. '''Its''' other sections provide post-installation tutorials like setting up a graphical user interface, sound or a touchpad.<br />
<br />
:::::-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 02:31, 8 October 2014 (UTC)<br />
<br />
:::::: Done, I'll close it. I've also added "'''links to''' post-installation tutorials ...". If anybody wants to talk about article's name for [[General recommendations]], please use corresponding talk page -- [[User:Kycok|Kycok]] ([[User talk:Kycok|talk]]) 08:44, 8 October 2014 (UTC)<br />
<br />
== Gummiboot instructions are out of order. ==<br />
<br />
I'm not certain if this is the same issue as the heading "gummiboot instructions are confusing?", but I encountered this using the Beginner's guide. In "2.4 Mount the partitions", it mentions that you should mount the ESP at /boot. But then in "2.8 Chroot and configure the base system", the root is changed to the new system's mountpoint, and /boot no longer refers to the mounted ESP partition (because this was mounted in the live installation CD, in zsh). When in "2.12.2 For UEFI motherboards" I run the gummiboot install command, it errors saying that it is not a fat32 partition. Furthermore, I'm not sure if I need to actually have the initramfs files that were made during pacstrap in the actual EFI since they were installed to /boot. (My thought is they should be, because the assumption was that the EFI has actually been mounted on /boot since before pacstrap was run.) <br />
<br />
I'm not certain what to do. (I'm new, this is my first time going through this guide.) Could someone please review this? Or perhaps I made a mistake somewhere...?<br />
<br />
[[User:Tmarks|Tmarks]] ([[User talk:Tmarks|talk]]) 14:23, 11 October 2014 (UTC)</div>Tmarks