--- wikisrc/users/jdf.mdwn 2013/03/06 00:00:16 1.21 +++ wikisrc/users/jdf.mdwn 2013/03/14 23:20:58 1.32 @@ -7,53 +7,58 @@ Note: This is not what I'm really working on, it's just a place to gather some notes I took about some topics. -## Guide migration +## The new NetBSD guide -I'm currently trying to migrate the NetBSD guide to the wiki. The relevant -files are these ones: - - * ccd - * cgd - * chap-exinst - * cons - * dns - * edit - * inst-media - * inst - * linux - * lvm - * mail - * net-intro - * net-practice - * net-services - * pam - * print - * rmmedia - -Already done: - - * audio - * bluetooth - * boot - * build - * carp - * index - * inetd - * intro - * fetch - * kernel - * misc - * raidframe - * rc - * tuning - * updating - * upgrading - * veriexec - * x - -I started working on it in `guide/`, though the original proposal -was to store it in `guide/netbsd`. However, whoever wants to change the -directory can do so. +The NetBSD guide, as well as its contents, is outdated. Of course there's +current documentation as well in it, but many parts of it are outdated. +The question is: What is the future of the NetBSD guide? + +Should we continue having something ordered by *book chapters*? Or should we +make it completely unordered with many howtos inside a wiki, which is also +printable, but not in a useful order? + +In my opinion, we should continue having a set of articles where the basic +subsystems of NetBSD are explained, but in the wiki. It shouldn't be too +difficult to create a book from that if you want to. +From all these subsystems, imho, the following topics should be covered: + +System basics: + + * Installation + * Security (CGD, PGP, veriexec, PAM) + * Disk handling (GPT, disklabel, MBR), creating filesystems, handling USB + flashdrives, automounting, CDs + * RAIDs with raidframe + * LVM + * Audio setup + * Keeping a NetBSD installation up-to-date + * The rc system, as compared to systemd and SysV + * Editing with vi + * X setup, graphics drivers, console drivers + * Backups with dump/restore and other options + * Printing (with cups?) + +Networking: + + * Basic network setup + * inetd setup + * Bluetooth + * DNS server setup and related issues + * Firewalling (describing *all* or linking guide of others) + +Building NetBSD: + + * Building the system with `build.sh` + * Configuring the kernel + * Fetching sources, staying -current + +Using extra packages: + + * Emulating Linux + * Using pkgsrc + * Using binary packages, using pkgin + * Installing a desktop environment + * Things to remember (e.g., no mplayer) ## NetBSD flavoured