Revert manual link fixes (use new build script instead)

community/samples/README.md

@@ -2,4 +2,4 @@
 
 | Sample Name   | Knative Component | Description                | Language(s)       |
 | --------------| ----------------- | -------------------------- | ----------------- |
-| Hello World   | Serving | A quick introduction that highlights how to deploy an app. | [Clojure](serving/helloworld-clojure/), [Dart](serving/helloworld-dart/), [Elixir](serving/helloworld-elixir/), [Haskell](serving/helloworld-haskell/), [Rust](serving/helloworld-rust/), [Shell](serving/helloworld-shell/), [Swift](serving/helloworld-swift/), [Vertx](serving/helloworld-vertx/) |
+| Hello World   | Serving | A quick introduction that highlights how to deploy an app. | [Clojure](./serving/helloworld-clojure/README.md), [Dart](./serving/helloworld-dart/README.md), [Elixir](./serving/helloworld-elixir/README.md), [Haskell](./serving/helloworld-haskell/README.md), [Rust](./serving/helloworld-rust/README.md), [Shell](./serving/helloworld-shell/README.md), [Swift](./serving/helloworld-swift/README.md), [Vertx](./serving/helloworld-vertx/README.md) |

community/samples/serving/helloworld-clojure/README.md

@@ -7,7 +7,7 @@ specified, it will use "World" as the TARGET.
 ## Prerequisites
 
 - A Kubernetes cluster with Knative installed. Follow the
-  [installation instructions](../../../../docs/install/)
+  [installation instructions](../../../install/README.md)
   if you need to create one.
 - [Docker](https://www.docker.com) installed and running on your local machine,
   and a Docker Hub account configured (we'll use it for a container registry).

community/samples/serving/helloworld-dart/README.md

@@ -8,7 +8,7 @@ that you can use for testing. It reads in the env variable `TARGET` and prints
 ## Prerequisites
 
 - A Kubernetes cluster with Knative installed. Follow the
-  [installation instructions](../../../../docs/install/)
+  [installation instructions](../../../install/README.md)
   if you need to create one.
 - [Docker](https://www.docker.com) installed and running on your local machine,
   and a Docker Hub account configured (we'll use it for a container registry).

community/samples/serving/helloworld-haskell/README.md

@@ -7,7 +7,7 @@ specified, it will use "World" as the TARGET.
 ## Prerequisites
 
 - A Kubernetes cluster with Knative installed. Follow the
-  [installation instructions](../../../../docs/install/)
+  [installation instructions](../../../install/README.md)
   if you need to create one.
 - [Docker](https://www.docker.com) installed and running on your local machine,
   and a Docker Hub account configured (we'll use it for a container registry).

community/samples/serving/helloworld-rust/README.md

@@ -8,7 +8,7 @@ TARGET is not specified, it will use "World" as the TARGET.
 ## Prerequisites
 
 - A Kubernetes cluster with Knative installed. Follow the
-  [installation instructions](../../../../docs/install/)
+  [installation instructions](../../../install/README.md)
   if you need to create one.
 - [Docker](https://www.docker.com) installed and running on your local machine,
   and a Docker Hub account configured (we'll use it for a container registry).

community/samples/serving/helloworld-shell/README.md

@@ -7,7 +7,7 @@ variable is not specified, the script uses `World`.
 ## Prerequisites
 
 - A Kubernetes cluster with Knative installed. Follow the
-  [installation instructions](../../../../docs/install/)
+  [installation instructions](../../../install/README.md)
   if you need to create one.
 - [Docker](https://www.docker.com) installed and running on your local machine,
   and a Docker Hub account configured (we'll use it for a container registry).

community/samples/serving/helloworld-swift/README.md

@@ -8,7 +8,7 @@ specified, the app uses "World" as the TARGET.
 
 - You must have a Kubernetes cluster with Knative installed. If you need to
   create a cluster, follow the
-  [installation instructions](../../../../docs/install/).
+  [installation instructions](../../../install/README.md).
 - You must have [Docker](https://www.docker.com) installed and running on your
   local machine, and a Docker Hub account configured (used for container
   registry).

community/samples/serving/helloworld-vertx/README.md

@@ -15,7 +15,7 @@ You must meet the following requirements to complete this sample:
 
 - A version of the Knative Serving component installed and running on your
   Kubernetes cluster. Follow the
-  [Knative installation instructions](../../../../docs/install/)
+  [Knative installation instructions](../../../install/README.md)
   if you need to create a Knative cluster.
 - The following software downloaded and install on your loacal machine:
   - [Java SE 8 or later JDK](http://www.oracle.com/technetwork/java/javase/downloads/index.html).

contributing/CONTRIBUTING.md

@@ -26,18 +26,18 @@ given the same level of review.
 ## Working groups
 
 The Knative contributors community is organized into a set of
-[working groups](WORKING-GROUPS/). Any contribution to Knative should be
+[working groups](WORKING-GROUPS.md). Any contribution to Knative should be
 started by first engaging with the appropriate working group.
 
 ## Code of conduct
 
 All members of the Knative community must abide by the
-[Code of Conduct](CODE-OF-CONDUCT/). Only by respecting each other can we
+[Code of Conduct](CODE-OF-CONDUCT.md). Only by respecting each other can we
 develop a productive, collaborative community.
 
 ## Team values
 
-We promote and encourage a set of [shared values](VALUES/) to improve our
+We promote and encourage a set of [shared values](VALUES.md) to improve our
 productivity and inter-personal interactions.
 
 ## Contributor license agreements
@@ -59,7 +59,7 @@ our
 [Team Drive](https://drive.google.com/corp/drive/folders/0APnJ_hRs30R2Uk9PVA)
 and sending an email to the appropriate working group's mailing list to let
 people know the doc is there. To get write access to the drive, you'll need to
-be a [member](ROLES/#member) of the Knative organization.
+be a [member](ROLES.md#member) of the Knative organization.
 
 We do not yet have a common design document template(TODO).
 
@@ -78,15 +78,15 @@ later join knative-dev if you want immediate access).
 ## Contributing documentation
 
 For more information about contributing to the Knative documentation, see
-[DOCS-CONTRIBUTING](DOCS-CONTRIBUTING/). A lot of the information on this
+[DOCS-CONTRIBUTING.md](DOCS-CONTRIBUTING.md). A lot of the information on this
 page still applies, but you'll find the specifics about the docs process there.
 
 ## Contributing a feature
 
 In order to contribute a feature to Knative you'll need to go through the
 following steps:
 
-- Discuss your idea with the appropriate [working groups](WORKING-GROUPS/) on
+- Discuss your idea with the appropriate [working groups](WORKING-GROUPS.md) on
   the working group's mailing list.
 
 - Once there is general agreement that the feature is useful,
@@ -115,7 +115,7 @@ following steps:
 
 - Submit PRs to knative/serving with user documentation for your feature,
   including usage examples when possible. Add documentation to
-  [knative/docs/serving](https://github.com/knative/docs/tree/master/serving).
+  [knative/docs/serving](../serving).
 
 _Note that we prefer bite-sized PRs instead of giant monster PRs. It's therefore
 preferable if you can introduce large features in small, individually-reviewable
@@ -170,9 +170,9 @@ This project uses
 [Prow](https://github.com/kubernetes/test-infra/tree/master/prow) to assign
 reviewers to the PR, set labels, run tests automatically, and so forth.
 
-See [Reviewing and Merging Pull Requests](REVIEWING/) for the PR review and
+See [Reviewing and Merging Pull Requests](REVIEWING.md) for the PR review and
 merge process used for Knative and for more information about
-[Prow](../REVIEWING/#prow).
+[Prow](./REVIEWING.md#prow).
 
 ## Issues
 

contributing/DOCS-CONTRIBUTING.md

@@ -15,7 +15,7 @@ propose changes to this document in a pull request.
 
 ### Code of conduct
 
-Knative follows the [Knative Code of Conduct](../CODE-OF-CONDUCT/). By
+Knative follows the [Knative Code of Conduct](./CODE-OF-CONDUCT.md). By
 participating, you are expected to uphold this code. Please report unacceptable
 behavior to [email protected].
 
@@ -39,7 +39,7 @@ see a problem with the documentation, submit an issue using the following steps:
      When you create a bug report, include as many details as possible and
      include suggested fixes to the issue. If you know which Knative component
      your bug is related to, you can assign the appropriate
-     [Working Group Lead](../WORKING-GROUPS/).
+     [Working Group Lead](./WORKING-GROUPS.md).
    - **Feature request**: For upcoming changes to the documentation or requests
      for more information on a particular subject.
 
@@ -51,7 +51,7 @@ documentation issues should go in the `docs` repository.
 
 ### Working group
 
-The [Knative Documentation Working Group](../WORKING-GROUPS/#documentation)
+The [Knative Documentation Working Group](./WORKING-GROUPS.md#documentation)
 meets weekly on Tuesdays and alternates between a 9am PT and a 4:30pm PT time to
 accommodate contributors in both the EMEA and APAC timezones.
 [Click here](https://calendar.google.com/calendar/embed?src=google.com_18un4fuh6rokqf8hmfftm5oqq4%40group.calendar.google.com)
@@ -66,9 +66,9 @@ There are a couple different ways to jump in to the Knative doc set:
 
 - Look at issues in the Docs repo labled
   [Good First Issue](https://github.com/knative/docs/labels/kind%2Fgood-first-issue).
-- Run through the [install guide](../../install/docs/README.md) for the platform of your
+- Run through the [install guide](../install/README.md) for the platform of your
   choice, as well as the
-  [Getting Started with Knative App Deployment](../../install/docs/getting-started-knative-app/)
+  [Getting Started with Knative App Deployment](../install/getting-started-knative-app.md)
   guide, and keep a
   [friction log](https://devrel.net/developer-experience/an-introduction-to-friction-logging)
   of the experience. What was hard for you? Then open a PR with a few

contributing/README.md

@@ -1,6 +1,6 @@
 
 _Important_. Before proceeding, please review the Knative community
-[Code of Conduct](./CODE-OF-CONDUCT/).
+[Code of Conduct](CODE-OF-CONDUCT.md).
 
 If you any have questions or concerns, please contact the authors at
 [email protected].
@@ -21,25 +21,25 @@ improving docs, giving talks, etc.
 
 Other Documents
 
-- [Code of Conduct](./CODE-OF-CONDUCT/) - all contributors must abide by the
+- [Code of Conduct](CODE-OF-CONDUCT.md) - all contributors must abide by the
   code of conduct
-- [Contributing to Knative](./CONTRIBUTING/) - guidelines and advice on becoming
+- [Contributing to Knative](CONTRIBUTING.md) - guidelines and advice on becoming
   a contributor
-- [Working Groups](./WORKING-GROUPS/) - describes our various working groups
-- [Working Group Processes](./WORKING-GROUP-PROCESSES/) - describes how working
+- [Working Groups](WORKING-GROUPS.md) - describes our various working groups
+- [Working Group Processes](WORKING-GROUP-PROCESSES.md) - describes how working
   groups operate
-- [Technical Oversight Committee](./TECH-OVERSIGHT-COMMITTEE/) - describes our
+- [Technical Oversight Committee](TECH-OVERSIGHT-COMMITTEE.md) - describes our
   technical oversight committee
-- [Steering Committee](./STEERING-COMMITTEE/) - describes our steering committee
-- [Community Roles](./ROLES/) - describes the roles individuals can assume
+- [Steering Committee](STEERING-COMMITTEE.md) - describes our steering committee
+- [Community Roles](ROLES.md) - describes the roles individuals can assume
   within the Knative community
-- [Reviewing and Merging Pull Requests](./REVIEWING/) - how we manage pull
+- [Reviewing and Merging Pull Requests](REVIEWING.md) - how we manage pull
   requests
 
 ## Introduction
 
 Knative is a Kubernetes-based platform to build, deploy, and manage modern
-serverless workloads. See [Knative docs](../docs) for
+serverless workloads. See [Knative docs](../docs/README.md) for
 in-depth information about using Knative.
 
 ## Knative authors
@@ -56,23 +56,23 @@ tools, platforms, languages, and products. By submitting a tutorial you can
 share your experience and help others who are solving similar problems.
 
 Community tutorials are stored in Markdown files on
-[GitHub](../../community/samples/) where they can be reviewed and edited by the
+[GitHub](./samples/README.md) where they can be reviewed and edited by the
 community.
 
 Please submit a Pull Request to the community sample directory under the Knative
 component that your tutorial highlights - [Serving](../community/samples/serving/),
 [Eventing](../community/samples/eventing/), or [Build](../community/samples/build/). A reviewer will
 be assigned to review your submission. They'll work with you to ensure your
-submission meets the [style guide](./DOCS-CONTRIBUTING.md), but it helps if you
+submission meets the [style guide](DOCS-CONTRIBUTING.md), but it helps if you
 follow it as you write your tutorial.
 
 ## Meetings and work groups
 
 Knative has public and recorded bi-weekly community meetings.
 
-Each project has one or more [working groups](./WORKING-GROUPS/) driving the
+Each project has one or more [working groups](WORKING-GROUPS.md) driving the
 project, and Knative as a single
-[technical oversight community](./TECH-OVERSIGHT-COMMITTEE/) monitoring the
+[technical oversight community](TECH-OVERSIGHT-COMMITTEE.md) monitoring the
 overall project.
 
 ## How can I help
@@ -96,7 +96,7 @@ following resources are available for you:
 - [Knative Users](https://groups.google.com/forum/#!forum/knative-users)
 - [Knative Developers](https://groups.google.com/forum/#!forum/knative-dev)
 
-For contributors to Knative, we also have [Knative Slack](./SLACK-GUIDELINES/).
+For contributors to Knative, we also have [Knative Slack](SLACK-GUIDELINES.md).
 
 ---
 

contributing/REVIEWING.md

@@ -10,7 +10,7 @@ Code reviews increase both the quality and readability of our code base, which
 in turn produces high quality software.
 
 This document provides guidelines for how the project's
-[Members](ROLES/#member) review issues and merge pull requests (PRs).
+[Members](ROLES.md#member) review issues and merge pull requests (PRs).
 
 - [Pull requests welcome](#pull-requests-welcome)
 - [Code of Conduct](#code-of-conduct)
@@ -30,7 +30,7 @@ Please do not ever hesitate to ask a question or submit a PR.
 
 Reviewers are often the first points of contact between new members of the
 community and are important in shaping the community. We encourage reviewers to
-read the [code of conduct](CODE-OF-CONDUCT/) and to go above and
+read the [code of conduct](CODE-OF-CONDUCT.md) and to go above and
 beyond the code of conduct to promote a collaborative and respectful community.
 
 ## Code reviewers
@@ -69,18 +69,18 @@ require a rebase are not considered active PRs.
 
 ### Holds
 
-Any [Approver](ROLES/#approver) who wants to review a PR but does not have
+Any [Approver](ROLES.md#approver) who wants to review a PR but does not have
 time immediately can put a hold on a PR. If you need more time, say so on the PR
 discussion and offer an ETA measured in single-digit days at most. Any PR that
 has a hold will not be merged until the person who requested the hold acks the
 review, withdraws their hold, or is overruled by a majority of approvers.
 
 ## Approvers
 
-Merging of PRs is done by [Approvers](ROLES/#approver).
+Merging of PRs is done by [Approvers](ROLES.md#approver).
 
 As is the case with many open source projects, becoming an Approver is based on
-contributions to the project. See our [community roles](ROLES/) document for
+contributions to the project. See our [community roles](ROLES.md) document for
 information on how this is done.
 
 ## Merging PRs

contributing/ROLES.md

@@ -82,7 +82,7 @@ table describes:
         <p>Run their working group</p>
     </td>
     <td>Sponsored by the technical oversight committee as documented
-        <a href="./WORKING-GROUP-PROCESSES/">here</a>.
+        <a href="./WORKING-GROUP-PROCESSES.md">here</a>.
     </td>
     <td>Write permissions on one or more repos allowing issues to be manipulated.</td>
     <td>Working Group</td>
@@ -215,13 +215,13 @@ approver in an OWNERS file:
 
 - Demonstrate sound technical judgement
 
-- Responsible for project quality control via [code reviews](REVIEWING/)
+- Responsible for project quality control via [code reviews](REVIEWING.md)
 
   - Focus on holistic acceptance of contribution such as dependencies with other
     features, backward / forward compatibility, API and flag definitions, etc
 
 - Expected to be responsive to review requests as per
-  [community expectations](REVIEWING/)
+  [community expectations](REVIEWING.md)
 
 - Mentor members and contributors
 
@@ -260,7 +260,7 @@ Additional requirements for leads of a new working group:
 The following apply to the area / component for which one would be an owner.
 
 - Run their working group as explained in the
-  [Working Group Processes](WORKING-GROUP-PROCESSES/).
+  [Working Group Processes](WORKING-GROUP-PROCESSES.md).
 
 - Design/proposal approval authority over the area / component, though
   escalation to the technical oversight committee is possible.
@@ -275,7 +275,7 @@ The following apply to the area / component for which one would be an owner.
 - Capable of directly applying lgtm + approve labels for any PR
 
   - Expected to respect OWNERS files approvals and use
-    [standard procedure for merging code](REVIEWING/#merging-prs).
+    [standard procedure for merging code](REVIEWING.md#merging-prs).
 
 - Expected to work to holistically maintain the health of the project through:
 

contributing/SLACK-GUIDELINES.md

@@ -22,7 +22,7 @@ https://slack.knative.dev.
 
 ## Code of Conduct
 
-The Knative [Code of Conduct](../CODE-OF-CONDUCT/) applies throughout the
+The Knative [Code of Conduct](./CODE-OF-CONDUCT.md) applies throughout the
 project, and includes all communication mediums.
 
 ## Admins
@@ -56,7 +56,7 @@ privately.
 Please reach out to the #slack-admins group with your request to create a new
 channel.
 
-Channels are dedicated to [Working Groups](../WORKING-GROUPS/), sub-projects,
+Channels are dedicated to [Working Groups](./WORKING-GROUPS.md), sub-projects,
 community topics, and related programs/projects.
 
 Channels are not:

contributing/STEERING-COMMITTEE.md

@@ -18,7 +18,7 @@ work-in-progress._
 - Non-technical project oversight
 
   - Define policy for the creation and administration of community groups,
-    including [Working Groups](WORKING-GROUPS/) and Committees.
+    including [Working Groups](WORKING-GROUPS.md) and Committees.
 
   - Define and evolve project governance structures and policies, including
     project role assignment and contributor promotion.

contributing/TECH-OVERSIGHT-COMMITTEE.md

@@ -46,8 +46,8 @@ product and design decisions.
     community focus
 
   - Ensure the team adheres to our
-    [code of conduct](CONTRIBUTING/#code-of-conduct) and respects our
-    [values](VALUES/).
+    [code of conduct](CONTRIBUTING.md#code-of-conduct) and respects our
+    [values](VALUES.md).
 
   - Foster an environment for a healthy and happy community of developers and
     contributors.
@@ -87,7 +87,7 @@ during the community feedback period at the end of each meeting.
 ## Committee Members
 
 The members of the TOC are shown below. Membership in the TOC is determined by
-the [Steering committee](STEERING-COMMITTEE/).
+the [Steering committee](STEERING-COMMITTEE.md).
 
 |                                                          | Member        | Company | Profile                                            |
 | ------------------------------------------------------------- | ------------- | ------- | -------------------------------------------------- |