Add quick steps to make it easier to see download the code and build

Author: stwrt

Sources/WebKit/WebKit.docc/Build&Debug/Build.md

@@ -1,4 +1,4 @@
-# Building WebKit
+# Building Options
 
 An in depth guide of build options for WebKit.
 

Sources/WebKit/WebKit.docc/GettingStarted/ContributingCode.md

@@ -2,9 +2,9 @@
 
 WebKit has a rigorous code contribution process and policy in place to maintain the quality of code.
 
-## Getting setup to contribute
+## Getting Setup to Contribute
 
-After downloading the code please run the below command.
+Please run this command below to setup your environment to make pull requests.
 
 ```Bash
 git webkit setup

Sources/WebKit/WebKit.docc/GettingStarted/Introduction.md

@@ -45,45 +45,3 @@ It primarily consists of the following components, each inside its own directory
         All WebContent processes in a single session (default vs. private browsing) share a single networking session in the networking process.
 * **WebInspector / WebDriver** - WebKit’s developer tool & automation tool for Web developers.
 
-## Contributing to WebKit
-
-There are many ways to get involved and contribute to the WebKit Project.
-Filing a new bug, fixing a bug, or adding a new feature.
-
-There are three different kinds of contributors in the WebKit project.
-
- * Contributor - This category encompasses everyone. Anyone who files a bug or contributes a code change or reviews a code change is considered as a contributor
- * Committer - A committer is someone who has write access to [WebKit's repository](https://github.com/WebKit/WebKit).
- * Reviewer - A reviewer is someone who has the right to review and approve code changes other contributors proposed.
-
-See [Commit and Review Policy](https://webkit.org/commit-and-review-policy/) for more details on how to become a committer or a reviewer.
-
-### Staying in Touch
-
-Before getting in touch with WebKit developers using any of the avenues below, make sure that you have checked our page on how to ask [questions about WebKit](https://webkit.org/asking-questions/).
-
-You can find WebKit developers, testers, and other interested parties on the [#WebKit Slack workspace](https://webkit.slack.com/).
-[Join the WebKit slack](https://join.slack.com/t/webkit/shared_invite/enQtOTU3NzQ3NTAzNjA0LTc5NmZlZWIwN2MxN2VjODVjNzEyZjBkOWQ4NTM3OTk0ZTc0ZGRjY2MyYmY2MWY1N2IzNTI2MTIwOGVjNzVhMWE),
-and stay in touch.
-
-
-## Getting started with WebKit
-
-### Adding Tools to PATH
-
-For convenience, you can add `Tools/Scripts/` to your path as follows in `~/.zshrc` like so:
-
-```sh
-export PATH=$PATH:/Volumes/Data/webkit/Tools/Scripts/
-```
-
-where `/Volumes/Data/webkit` is the path to a WebKit checkout.
-
-This will allow you to run various tools you by name instead of typing the full path of the script.
-
-### Updating checkouts
-
-There is a script to update a WebKit checkout: `Tools/Scripts/update-webkit`.
-
-That will replace your old pull request with a new one with the new changes, while also updating the pull request's description with your current commit message.
-

Sources/WebKit/WebKit.docc/Other/Contributors.md

@@ -0,0 +1,11 @@
+# Contributors
+
+## Overview
+
+There are three different kinds of contributors in the WebKit project.
+
+ * Contributor - This category encompasses everyone. Anyone who files a bug or contributes a code change or reviews a code change is considered as a contributor
+ * Committer - A committer is someone who has write access to [WebKit's repository](https://github.com/WebKit/WebKit).
+ * Reviewer - A reviewer is someone who has the right to review and approve code changes other contributors proposed.
+
+See [Commit and Review Policy](https://webkit.org/commit-and-review-policy/) for more details on how to become a committer or a reviewer.

Sources/WebKit/WebKit.docc/WebKit.md

@@ -2,29 +2,37 @@
 
 WebKit is a cross-platform web browser engine. On iOS and macOS, it powers Safari, Mail, iBooks, and many other applications.
 
-## Downloading the Source Code
+## Getting Up and Running Quickly
 
-```
+### Downloading the Source Code
+
+```sh
 git clone https://github.com/WebKit/WebKit.git WebKit
 ```
 
-## Building WebKit
+### Building WebKit
 
-```
+```sh
 cd WebKit
 Tools/Scripts/build-webkit
 ```
 
-## Running Minibrowser
+### Running Minibrowser
 
-```
+```sh
 Tools/Scripts/run-minibrowser
 ```
 
+### (Optional) Add Scripts Directory to your PATH
+
+```sh
+export PATH=$PATH:`pwd`/Tools/Scripts
+```
+
 ## Contribute
 
 Congratulations! You’re up and running. Now you can begin coding in WebKit and contribute your fixes and new features to the project. 
-For details on submitting your code to the project, read [Contributing Code](https://webkit.org/contributing-code/).
+For details on submitting your code to the project, read <doc:ContributingCode>.
 
 ## Feature Status
 
@@ -45,6 +53,13 @@ On Windows, you will have to build it yourself.
 Once your bug is filed, you will receive email when it is updated at each stage in the [bug life cycle](https://webkit.org/bug-life-cycle). 
 After the bug is considered fixed, you may be asked to download the [latest nightly](https://webkit.org/nightly) and confirm that the fix works for you.
 
+## Staying in Touch
+
+Before getting in touch with WebKit developers using any of the avenues below, make sure that you have checked our page on how to ask [questions about WebKit](https://webkit.org/asking-questions/).
+
+You can find WebKit developers, testers, and other interested parties on the [#WebKit Slack workspace](https://webkit.slack.com/).
+[Join the WebKit slack](https://join.slack.com/t/webkit/shared_invite/enQtOTU3NzQ3NTAzNjA0LTc5NmZlZWIwN2MxN2VjODVjNzEyZjBkOWQ4NTM3OTk0ZTc0ZGRjY2MyYmY2MWY1N2IzNTI2MTIwOGVjNzVhMWE),
+and stay in touch.
 
 ## Topics
 
@@ -87,4 +102,5 @@ After the bug is considered fixed, you may be asked to download the [latest nigh
 - <doc:ContributorMeetings>
 - <doc:Licensing>
 - <doc:CI>
+- <doc:Contributors>
 - <doc:Todo>