Tweaked project documentation.

This commit makes a few tweaks to the project documentation.

Signed-off-by: Jacob Howard <[email protected]>

Author: xenoscopic

BUILDING.md

@@ -1,27 +1,32 @@
 # Building
 
-Mutagen is *not* `go get`able for end-users because it needs to cross-compile
-agent binaries for remote platforms and generate a bundle of these binaries. In
-general, users should download the release builds from the
-[releases page](https://github.com/mutagen-io/mutagen/releases/latest).
-
-Mutagen can, however, be built locally for testing and development. Mutagen
+Mutagen's build is slightly unique because it needs to cross-compile agent
+binaries for remote platforms (with cgo support in the case of macOS) and then
+generate a bundle of these binaries to ship alongside the Mutagen CLI. As such,
+using `go get` or `go install` to acquire Mutagen will result in an incomplete
+installation, and users should instead download the release builds from the
+[releases page](https://github.com/mutagen-io/mutagen/releases/latest) or
+[install Mutagen](https://mutagen.io/documentation/introduction/installation)
+via [Homebrew](https://brew.sh/).
+
+However, Mutagen can be built locally for testing and development. Mutagen
 relies on the Go toolchain's module support, so make sure that you have Go
 module support enabled.
 
 Individual Mutagen executables can be built normally using the Go toolchain, but
-a script is provided to manage cross-compiled builds and agent bundle creation.
-To see information about the build script, run:
+a script is provided to ensure a normalized build, manage cross-compiled builds
+and agent bundle creation, and perform code signing on macOS. To see information
+about the build script, run:
 
     go run scripts/build.go --help
 
 The build script can do four different types of builds: `local` (with support
-for the local system only), `slim` (with support for a selection of common
-platforms used in testing), `release` (used for generating complete release
-artifacts), and `release-slim` (used for generating complete release artifacts
-for a selection of common platforms used in testing). macOS is currently the
-only platform that supports doing `release` builds, because the macOS binaries
-require cgo support for file monitoring.
+for the local system only), `slim` (the default - with support for a selection
+of common platforms used in testing), `release` (used for generating complete
+release artifacts), and `release-slim` (used for generating complete release
+artifacts for a selection of common platforms used in testing). macOS is
+currently the only platform that supports doing `release` builds, because the
+macOS binaries require cgo support for filesystem monitoring.
 
 All artifacts from the build are placed in a `build` directory at the root of
 the Mutagen source tree. As a convenience, artifacts built for the current

CONTRIBUTING.md

@@ -30,10 +30,12 @@ email us at [[email protected]](mailto:[email protected]).
 
 ---
 
-**Please note:** Mutagen is currently in a state of high code churn and I simply
-don't have the time to review pull requests. GitHub unfortunately doesn't allow
-me to disable pull requests, but please be aware that they will probably be left
-on the back burner for the foreseeable future. Sorry :-(
+**Please note:** I'm still working on formulating Mutagen's pull request policy.
+I'm trying to make it as simple as possible while ensuring code quality and
+project longevity. I very much want community contributions, but I haven't had
+an extensive amount of time to review pull requests or formulate a review
+process. I'm working on changing this, so I ask you to bear with me for just a
+little longer. Thank you!
 
 – Jacob
 
@@ -48,18 +50,16 @@ guidelines. Pull requests that don't follow these guidelines will simply be
 closed.
 
 
-### Developer Certificate of Origin
+### Contributor License Agreement
 
-Pull requests to Mutagen must be submitted under the terms of the
-[Developer Certificate of Origin (DCO)](DCO). In order to accept a pull request,
-we require that you sign-off all commits in the pull request using the `-s` flag
-with `git commit` to indicate that you agree to the terms of the DCO.
+Mutagen pull requests will require a Contributor License Agreement, though the
+exact form of this agreement is still being decided.
 
 
 ### Code guidelines
 
 In order to ensure that Mutagen's codebase remains clean and understandable to
-newcomers, we kindly request that:
+all developers, we kindly request that:
 
 - Code adheres to Go style guidelines, including those in
   [Effective Go](https://golang.org/doc/effective_go.html) and the

DCO

@@ -1,8 +1,8 @@
 # Security
 
-If you find a security issue with Mutagen, please DO NOT submit it via the issue
-tracker! Instead, please follow responsible disclosure practices and send
-information about security issues directly to
+If you find a security issue with Mutagen or one of its related projects, please
+DO NOT submit it via the issue tracker! Instead, please follow responsible
+disclosure practices and send information about security issues directly to
 [[email protected]](mailto:[email protected]) so that a proper assessment
 can be made and a fix prepared before a wide announcement. You will receive an
 acknowledgement within 24 hours. If you do not, please contact the project
@@ -15,4 +15,4 @@ as soon as possible. We can work together to investigate, debug, and assess.
 You may also direct questions, feedback, or suggestions about Mutagen's security
 policy to the same email addresses.
 
-Your help is greatly appreciated in keeping Mutagen secure!
+Your help is greatly appreciated in keeping Mutagen code secure!