cleanup and copy editing for launch of site

Author: jclulow

docs/about/distro.md

@@ -1,40 +1,29 @@
-# the illumos family
+# illumos Distributions
 
 ## Introduction
 
 Similar to other operating systems, there are many different OS distributions
 based on the common illumos ecosystem.
 
-Some of them are maintained by enthusiasts, others are primarily developed by
-commercial companies with their own priorities and focus, and some mainly
-differ in their packaging systems.
-
-Most of these projects contribute back to the common core set of software, which the
-illumos project is all about.
-
+Some distributions are maintained by enthusiasts, while others are primarily
+developed by companies with their own priorities and focus.
 
 ## Comparison
 
-All illumos-derived systems should include our [common technologies](features.md).
+All illumos-derived systems should include our [common
+technologies](features.md).
 
-Not all distributions have the latest features or run on both x86 and SPARC.
+Not all distributions have the latest features, or run on both x86 and SPARC.
 
 For major feature differences, the following chart may be helpful.
 
-### Active Spins
-
 | Project | Provider | Focus | Linux Comparison | Open Source | Packaging | x86 | SPARC | KVM | LX | 
 |---------|----------|-------|------------------|-------------|-----------|------|------|-----|----|
-| [SmartOS](https://smartos.org) | [Joyent](https://www.joyent.com) | Hypervisor | CoreOS | <i class="material-icons">check</i> | [pkgsrc](https://pkgsrc.joyent.com) | <i class="material-icons">check</i> |  | <i class="material-icons">check</i> | <i class="material-icons">check</i> |
 | [OmniOS CE](https://www.omniosce.org/) | [OmniOS Community Association](https://omniosce.org/about/about) | Servers | Debian | <i class="material-icons">check</i> | IPS | <i class="material-icons">check</i> | | <i class="material-icons">check</i> | <i class="material-icons">check</i> |
 | [OpenIndiana](https://www.openindiana.org/) | [OpenIndiana](https://www.openindiana.org/) | Workstation, Servers | Ubuntu | <i class="material-icons">check</i> | IPS | <i class="material-icons">check</i> | | <i class="material-icons">check</i> | |
+| [SmartOS](https://smartos.org) | [Joyent](https://www.joyent.com) | Hypervisor | CoreOS | <i class="material-icons">check</i> | [pkgsrc](https://pkgsrc.joyent.com) | <i class="material-icons">check</i> |  | <i class="material-icons">check</i> | <i class="material-icons">check</i> |
 | [NexenStor](https://community.nexenta.com/s/) | [Nexenta](https://nexenta.com/) | Storage | | | APT | <i class="material-icons">check</i> | |
 | [Tribblix](http://www.tribblix.org/) | Peter Tribble | Workstation, Servers | Slackware | <i class="material-icons">check</i> | SVR4 | <i class="material-icons">check</i> | <i class="material-icons">check</i> | | <i class="material-icons">check</i> | |
 | [DilOS](http://www.dilos.org/) | igork | Workstation, Servers | | <i class="material-icons">check</i> | APT | <i class="material-icons">check</i> | <i class="material-icons">check</i> | <i class="material-icons">check</i> | <i class="material-icons">check</i> |
-
-### Unmaintained Spins
-
-| Project | Provider | Focus | Open Source | Packaging | x86 | SPARC |
-|---------|----------|-------|-------------|-----------|-----|-------|
-| [v9os](http://www.milax.fi/v9os.html) | [MilaX](http://www.milax.fi/) | Server | <i class="material-icons">check</i> | IPS | | <i class="material-icons">check</i> |
 | [XStreamOS](http://www.sonicle.com/xstreamos/) | [Sonicle](http://www.sonicle.com/) | Server | | |<i class="material-icons">check</i> | |
+| [v9os](http://www.milax.fi/v9os.html) | [MilaX](http://www.milax.fi/) | Server | <i class="material-icons">check</i> | IPS | | <i class="material-icons">check</i> |

docs/about/faq.md

@@ -1,6 +1,5 @@
 ## Quick Links
 
-* [Security Information](../security/index.md)
 * [Manual pages](https://illumos.org/man)
 * [Mailing lists](../community/lists.md)
 * [Bug reporting](../user-guide/bugs.md)
@@ -31,16 +30,15 @@ The illumos code base forms the foundation of [distributions](distro.md).
 To use the operating system, just download and install one of the
 distributions.
 
-To download the source code, review [How To Build
-illumos](../developers/index.md). You can also
-[browse](https://github.com/illumos/illumos-gate) and
-[search](http://src.illumos.org).
+To download the source code, review [Building illumos](../developers/build.md).
+You can also [browse on GitHub](https://github.com/illumos/illumos-gate) or
+[search on OpenGrok](http://src.illumos.org).
 
 ## Is illumos free software (open source)?
 
-The bulk of the illumos source code is available under the Common Development
-and Distribution License (CDDL), an OSI-approved free software license based on
-the Mozilla Public License (MPL).
+The bulk of the illumos source code is available under the [Common Development
+and Distribution License (CDDL)](https://illumos.org/license/CDDL), an
+OSI-approved free software license based on the Mozilla Public License (MPL).
 
 There are some components with other licenses including BSD and MIT. We also
 include some software with the GNU General Public License (GPL) or the
@@ -77,7 +75,7 @@ and you're invited to drop in and say "hi!"
 
 ## How do I build illumos?
 
-See [How To Build illumos](../developers/index.md).
+See [Building illumos](../developers/build.md).
 
 ## How do I build a distribution based on illumos?
 

docs/about/features.md

@@ -3,15 +3,14 @@
 illumos provides a number of advanced features for downstream distributions and
 users to utilize.
 
-### Filesystems
+### OpenZFS
 
-#### OpenZFS
-
-We are the canonical upstream for the [OpenZFS Project](http://open-zfs.org/).
+The illumos project is part of the community of operating system projects that
+ships [OpenZFS](http://open-zfs.org/).
 
 ZFS provides excellent data integrity, performance, flexibility and
-ease-of-use you simply can't find in other filesystems. ZFS combines
-traditional concepts like volume management and filesystems with a pooled
+ease-of-use you simply can't find in other file systems. ZFS combines
+traditional concepts like volume management, and file systems with a pooled
 storage that does for disks what virtual memory did for RAM.
 
 ZFS was developed at Sun Microsystems in the early 2000s and released as open
@@ -23,10 +22,10 @@ ZFS allows you to:
 
 * Group devices into a single storage pool with various redundancy characteristics
 * Create tiered storage with log and cache devices
-* Create read-only atomic filesystem snapshots
+* Create read-only atomic file system snapshots
 * Create writable clones of snapshots
 * Send snapshots as a byte stream -- which you can redirect to a file, or send across the network!
-* Dynamically modify dataset (filesystem) attributes
+* Dynamically modify dataset (file system) attributes
 * Delegate dataset management to non-root users or groups
 
 ZFS includes online checksumming of every block, on-demand scrubbing of disks,
@@ -38,50 +37,36 @@ X](https://openzfsonosx.org/) -- and a [Windows
 port](https://github.com/openzfsonwindows/ZFSin) is in progress as of late
 2017!
 
-#### Others
-
-illumos provides a number of [other filesystems](https://illumos.org/man/7FS/all), including:
-
-* [Loopback](https://illumos.org/man/7FS/lofs)
-* [Temporary](https://illumos.org/man/7FS/tmpfs)
-* [UFS](https://illumos.org/man/7FS/ufs)
-* [HSFS](https://illumos.org/man/7FS/hsfs)
-* [NFS](https://illumos.org/man/1M/nfsd)
-* [FAT](https://illumos.org/man/7FS/pcfs)
-* [CIFS](https://illumos.org/man/7FS/smbfs)
-* [UDFS](https://illumos.org/man/7FS/udfs)
-
 ### Virtualization
 
-illumos offers a number of virtualization options, including lightweight
-"operating system zones", Linux emulated zones, and KVM.
+illumos includes a number of virtualization technologies, including:
 
-!!! tip "Terminology"
-    In illumos, the global context is referred to as the _global zone_, or
-    _GZ_.
+- Zones, a light weight operating system-level virtualization; analogous
+  to "jails" or "containers" as provided by other systems
+- Hardware virtualization
 
-    Other zone "brands" are _non-global zones_, _NGZ_, or simply _zones_.
+#### Native Zones
 
-#### Native OS
-
-Native OS zones provide an isolated illumos environment to run your
-applications in.
+Native zones provide an isolated illumos environment to run your applications
+in, like having a virtual machine without the hypervisor overhead.
 
 #### LX (Linux Emulation)
 
-LX-branded zones provide the Linux syscall interface allowing you to run most
-Linux applications. While not yet upstreamed,
-[several illumos distributions](./distro.md) support it.
+LX-branded zones provide the Linux system call interface, allowing you to run
+most Linux application binaries without recompiling them for illumos. This
+facility is available in several illumos distributions, including SmartOS and
+OmniOS.
 
 #### KVM
 
-KVM (and QEMU) was ported to illumos in 2011, and can be used on Intel CPUs with
-VMX and EPT support.
+KVM and QEMU were ported to illumos in 2011, and can be used on Intel CPUs
+with VMX and EPT support.
 
-#### bhyve (Under development!)
+#### bhyve
 
-Joyent is in the process of porting FreeBSD's bhyve to illumos. It should be
-available for testing soon!
+Joyent is in the process of porting the bhyve hypervisor from FreeBSD to
+illumos.  The port is available in at least the SmartOS and OmniOS
+distributions.
 
 ### Introspection and Debugging
 
@@ -92,32 +77,28 @@ the operating system, as well as gathering profiling data. DTrace along with MDB
 allows you to leverage [CTF data](https://illumos.org/man/4/ctf) to inspect
 userland and kernel structures.
 
-#### Modular Debugger
-
-MDB, the illumos modular debugger, allows you to inspect running processes, core
-files, kernel state, and kernel crash dumps.
-[KMDB](https://illumos.org/man/1/kmdb) also allows controlling the execution of a
-running kernel.
+#### Modular Debugger (MDB)
 
-### Fault Management
+MDB, the illumos modular debugger, allows you to inspect running processes,
+core files, kernel state, and kernel crash dumps.
+[KMDB](https://illumos.org/man/1/kmdb) also allows controlling the execution of
+a running kernel.
 
-### Service Management
+### Service Management Facility (SMF)
 
 [SMF](https://illumos.org/man/5/smf) helps administrators manage services
 running on the system. SMF can take care of tracking service dependencies,
-restart policies, disabling perpetually crashing applications, and more.
+supervising and restarting processes, disabling perpetually crashing
+applications, and more.
 
 ### Firewall
 
-illumos uses [ipfilter](https://illumos.org/man/5/ipfilter) for firewalling. Using
-ipfilter you can create firewalls not just for the host system, but also for
-zones and hardware virtualized systems.
+illumos uses [ipfilter](https://illumos.org/man/5/ipfilter) for firewalling.
+Using ipfilter you can create firewalls not just for the host system, but also
+for zones and hardware virtualized systems.
 
 ### Virtual Networking
 
 [dladm(1M)](https://illumos.org/man/1M/dladm) allows users to create Virtual
-NICs, bridges, and in some distributions
-[overlay networks](https://smartos.org/man/5/overlay).
-
-### Security
-
+NICs, bridges, and in some distributions [overlay
+networks](https://smartos.org/man/5/overlay).

docs/about/index.md

@@ -1,4 +1,4 @@
-# what *is* illumos?
+# What is illumos?
 
 To quote the [illumos Developer's Guide](https://illumos.org/books/dev/):
 
@@ -11,35 +11,37 @@ To quote the [illumos Developer's Guide](https://illumos.org/books/dev/):
     traces it roots back through Sun Microsystems to the original releases of
     UNIX and BSD.
 
-illumos itself does not offer an OS distribution -- it is the core from which
-[distributions](distro.md) can be created. In this sense, illumos is similar to
-a BSD source tree, or Linux's kernel.org.
+illumos itself does not offer an OS distribution -- rather, it is the core from
+which [distributions](distro.md) can be created. In this sense, illumos is
+similar to a BSD source tree, or Linux's kernel.org.
 
 Please see the [history page](history.md) for more information about the
 origins of illumos.
 
-### Licensing
+### License
 
-illumos is licensed under the [CDDL](https://en.wikipedia.org/wiki/Common_Development_and_Distribution_License).
+illumos is available under the [Common Development and Distribution License
+(CDDL)](https://illumos.org/license/CDDL).
 
 ### Community Values
 
-* Empathy as a core engineering tenet
-* Code quality and correctness
+* Empathy for users as a core engineering value
+* Maintaining code quality through peer review
 
 ### Technology Features
 
-The following are shared development tenets and features for distributions utilizing illumos:
+The following are shared development tenets and features for distributions
+utilizing illumos:
 
 * Stability
 * SMP support for many CPUs
-* Security multi-user facilities like Roles and Privileges
+* Security facilities like Role-based Access Control (RBAC) and Privileges
 * Multi-tenancy with Zones
-* Unparalleled system introspection with [DTrace](http://dtrace.org/guide/)
-* A single pipeline for system issues with the Fault Management Architecture (FMA)
+* Deep system introspection with [DTrace](http://dtrace.org/guide/)
+* A unified Fault Management Architecture (FMA) for monitoring hardware
 * Network virtualization with Crossbow
 * Hardware virtualization with KVM
-* [Excellent online documentation](https://www.illumos.org/man/)
+* [Excellent manual pages](https://illumos.org/man/)
 * [Source code for the entire system](https://github.com/illumos/illumos-gate)
 
 For more in-depth descriptions, please see the [features page](features.md).
@@ -55,33 +57,34 @@ are being used for!
 
 ### Supported hardware platforms
 
-illumos currently supports: 
-
- * i86pc (x86, x86_64) architectures
- * AMD64 (except KVM support)
+illumos currently best suports 64-bit x86 hardware from Intel and AMD.
 
 There are also several SPARC distributions of illumos; if you are interested in
 running illumos on SPARC, please refer directly to those distributions' docs.
 
 To determine if a specific piece of hardware will work with illumos, please
-refer to the [Hardware Compatability List](https://www.illumos.org/hcl/).
+refer to the [Hardware Compatability List](https://illumos.org/hcl/).
 
-For pre-defined builds of server-grade hardware, you may also refer to
-[Joyent Engineering Manufactory
+For pre-defined builds of server-grade hardware, you may also refer to [Joyent
+Engineering Manufactoring
 database](http://eng.joyent.com/manufacturing/bom.html).    
 
 ### illumos Development Model
 
-Please refer to the [illumos Developer's Guide](https://illumos.org/books/dev/)
-and the [development section](../developers/index.md).
+Please refer to the [illumos Developer's
+Guide](https://illumos.org/books/dev/), as well as the [Building
+illumos](../developers/build.md) and [contribution](../contributing/index.md)
+sections of this documentation.
 
 ### Contributing to illumos
 
-Please see the [contribution](../contributing/index.md) if you'd like to
-participate in the project.
+Please see the [community](../community/index.md) and
+[contribution](../contributing/index.md) guides if you'd like to participate in
+the project.
 
 ### Third Party Software
 
-illumos does not itself ship third party software, or contain software like webservers and so forth. 
+illumos does not itself ship third party software, or contain software like
+webservers and so forth.
 
 Distributions include their own package management.

docs/about/leadership.md

@@ -8,13 +8,13 @@ Council, and Request To Integrate (RTI) Advocates.
 The Dev Council is a technical steering committee drawn from well-known
 developers of Solaris, whose role is to make high-level architecture decisions.
 
-| Member          | Organization |
-| --------------- | ------------ |
-| Adam Leventhal  | Delphix      |
-| Bryan Cantrill  | Joyent       |
-| Garrett D'Amore | unaffiliated |
-| Gordon Ross     | Nexenta      |
-| Rich Lowe       | unaffiliated |
+| Member          | Organization    |
+| --------------- | --------------- |
+| Adam Leventhal  | Transposit      |
+| Bryan Cantrill  | Joyent          |
+| Garrett D'Amore | RackTop Systems |
+| Gordon Ross     | Nexenta         |
+| Rich Lowe       | unaffiliated    |
 
 ## Advocates
 
@@ -24,18 +24,18 @@ stability for all illumos users.
 
 Advocates are appointed by the illumos Developer Council.
 
-| Member            | Handle     | Organization | Expertise |
-| ----------------- | ---------- | ------------ | --------- |
-| Albert Lee        | trisk      | SoftNAS      | Storage, drivers, userland. |
-| Chris Siden       | csiden     | Delphix      | ZFS |
-| Dan McDonald      | danmcd     | Joyent       | Cryptography, Networking |
-| Garrett D'Amore   | gdamore    | unaffiliated | Drivers, etc. |
-| Gordon Ross       | gwr        | Nexenta      | CIFS/SMB, VFS layer, ZFS ACLs, etc. |
-| Hans Rosenfeld    | Woodstock  | Joyent       | Misc. |
-| Joshua M. Clulow  | LeftWing   | Joyent       | Misc. |
-| Matt Ahrens       | mahrens    | Delphix      | ZFS |
-| Rich Lowe         | richlowe   | unaffiliated | Misc. |
-| Robert Mustacchi  | rmustacc   | Joyent       | Virtualization, SMF, PCI, MDB, DTrace, x86 platform, etc. |
+| Member            | Handle     | Organization    | Expertise |
+| ----------------- | ---------- | --------------- | --------- |
+| Albert Lee        | trisk      | SoftNAS         | Storage, drivers, userland. |
+| Chris Siden       | csiden     | Delphix         | ZFS |
+| Dan McDonald      | danmcd     | Joyent          | Cryptography, Networking |
+| Garrett D'Amore   | gdamore    | RackTop Systems | Drivers, etc. |
+| Gordon Ross       | gwr        | Nexenta         | CIFS/SMB, VFS layer, ZFS ACLs, etc. |
+| Hans Rosenfeld    | Woodstock  | Joyent          | Misc. |
+| Joshua M. Clulow  | LeftWing   | Joyent          | Misc. |
+| Matt Ahrens       | mahrens    | Delphix         | ZFS |
+| Rich Lowe         | richlowe   | unaffiliated    | Misc. |
+| Robert Mustacchi  | rmustacc   | Joyent          | Virtualization, SMF, PCI, MDB, DTrace, x86 platform, etc. |
 
 ## Life as an Advocate
 

docs/about/logo-1.md

@@ -1 +1 @@
-svg [scalable](../images/logo/PhoenixRGB.svg)<br>eps [scalable](../images/logo/PhoenixRGB.eps)<br>png [64px](../images/logo/Phoenix64x64-RGB.png)<br>png [166px](../images/logo/PhoenixRGB.png)<br>png [2057px](../images/logo/BigHighResPhoenixRGB.png)
+<b>Bare Logo:</b><br> svg [scalable](../images/logo/PhoenixRGB.svg)<br>eps [scalable](../images/logo/PhoenixRGB.eps)<br>png [64px](../images/logo/Phoenix64x64-RGB.png)<br>png [166px](../images/logo/PhoenixRGB.png)<br>png [2057px](../images/logo/BigHighResPhoenixRGB.png)

docs/about/logo-2.md

@@ -1 +1 @@
-svg scalable optimized for [smaller](../images/logo/SmallPhoenixLogotypeRGB.svg) sizes<br> svg scalable optimized for [larger](../images/logo/LargePhoenixLogotypeRGB.svg) sizes<br> eps scalable optimized for [smaller](../images/logo/DarkSmallPhoenixLogotypeRGB.eps) sizes<br> eps scalable optimized for [larger](../images/logo/LargePhoenixLogotypeRGB.eps) sizes<br> png [90px wide](../images/logo/TinyPhoenixLogotypeRGB.png)<br> png [139px wide](../images/logo/SmallPhoenixLogotypeRGB.png)<br> png [267px wide](../images/logo/MediumPhoenixLogotypeRGB.png)<br> png [3320px wide](../images/logo/BigHighResPhoenixLogotypeRGB.png)<br>
+<b>Logo with text, light background:</b><br> svg scalable optimized for [smaller](../images/logo/SmallPhoenixLogotypeRGB.svg) sizes<br> svg scalable optimized for [larger](../images/logo/LargePhoenixLogotypeRGB.svg) sizes<br> eps scalable optimized for [smaller](../images/logo/DarkSmallPhoenixLogotypeRGB.eps) sizes<br> eps scalable optimized for [larger](../images/logo/LargePhoenixLogotypeRGB.eps) sizes<br> png [90px wide](../images/logo/TinyPhoenixLogotypeRGB.png)<br> png [139px wide](../images/logo/SmallPhoenixLogotypeRGB.png)<br> png [267px wide](../images/logo/MediumPhoenixLogotypeRGB.png)<br> png [3320px wide](../images/logo/BigHighResPhoenixLogotypeRGB.png)<br>