fix broken links and references and fix tables

- links and refs were broken due to a directory reorganization - fixed broken file and header references - remove unnecessary/non-fixable references - fix and format tables, this enhances readibility in raw markdown - fixes #1084 Signed-off-by: Avinal Kumar <[email protected]>
tektoncd · Oct 18, 2023 · 0475e40 · 0475e40
1 parent a5ab035
commit 0475e40
Show file tree

Hide file tree

Showing 75 changed files with 409 additions and 417 deletions.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -11,8 +11,8 @@ and the individual `CONTRIBUTING.md` files in each respective project.
 
 This repo contains documentation about interacting with the community as well as standard
 and processes that apply to all repos in `tektoncd`. PRs are welcome and should follow
-[the tektoncd pull request process](process.md#pull-request-process).
+[the tektoncd pull request process](./process/README.md#pull-request-process).
 
-The [OWNERS](OWNERS) of this repo are the [members of the Tekton governing board](goverance.md).
+The [OWNERS](OWNERS) of this repo are the [members of the Tekton governing board](./governance.md).
 Any substantial changes to the policies in this repo should be reviewed by at least 50% of the
 governing board.
diff --git a/README.md b/README.md
@@ -22,7 +22,7 @@ See our standards regarding:
 
 - [Code of conduct](code-of-conduct.md)
 - [Design principles](design-principles.md)
-- [Commits](standards.md#commits)
+- [Commits](standards.md#commit-messages)
 - [Code](standards.md#code)
 - [User profiles](user-profiles.md)
 - [Releases](releases.md)
@@ -33,7 +33,7 @@ Find out about our processes:
 - [Propose features](./process/README.md#proposing-features)
 - [Contributor ladder](./process/contributor-ladder.md)
 - Pull request [reviews](./process/README.md#reviews) and [process](./process/README.md#pull-request-process)
-- [Propose projects](./process/README.md#proposing-projects)
+- [Propose projects](./process/projects.md)
 - [GitHub Org Management](org/README.md), including
   [requirements to join the org](org/README.md#requirements)
 - [The CDF CLA](./process/README.md#cla)

diff --git a/adopters.md b/adopters.md
@@ -8,41 +8,41 @@ Tell us about, we welcome [pull requests](https://github.com/tektoncd/community/
 
 ## Open Source Projects
 
-| Project Name | Description | Repository |
-|--------------|-------------|---------|
-| [Shipwright](https://shipwright.io/)   | Shipwright is an extensible framework for building container images on Kubernetes. | [https://github.com/shipwright-io](github.com/shipwright-io)
-| [Jenkins X](https://jenkins-x.io/)    | All In One CI/CD including everything you need to start exploring Kubernetes | [github.com/jenkins-x](https://github.com/jenkins-x) |
-| kfp-tekton | Kubeflow Pipelines SDK for Tekton | [github.com/kubeflow/kfp-tekton](https://github.com/kubeflow/kfp-tekton/) |
-| OpenShift Pipelines | OpenShift Pipelines is a cloud-native, continuous integration and continuous delivery (CI/CD) solution based on Kubernetes resources. | [github.com/openshift-pipelines](https://github.com/openshift-pipelines) |
-| FRSCA | OpenSSF's Factory for Repeatable Secure Creation of Artifacts (aka FRSCA pronounced Fresca) aims to help secure the supply chain by securing build pipelines. | [github.com/buildsec/frsca](https://github.com/buildsec/frsca) |
-| VSCode Tekton extension | VSCode extension to manage Tekton resources. | [github.com/redhat-developer/vscode-tekton](https://github.com/redhat-developer/vscode-tekton) |
-| JetBrains IDEs Tekton plugin | JetBrains IDEs plugin to manage Tekton resources. | [github.com/redhat-developer/intellij-tekton](https://github.com/redhat-developer/intellij-tekton) |
-| Automatiko Approval task | Brings approval tasks into Tekton pipeline with various strategies (single approval, multiple approvals, four eye based approval). | [github.com/automatiko-io/automatiko-approval-task](https://github.com/automatiko-io/automatiko-approval-task) |
-| [EPAM Delivery Platform (EDP)](https://epam.github.io/edp-install/) | Cloud-agnostic SaaS/PaaS solution for software development with a pre-defined set of CI/CD pipelines and tools, enabling to kickstart development quickly with established processes for code review, release, versioning, branching, and deployment. | [github.com/epam/edp-tekton](https://github.com/epam/edp-tekton)
+| Project Name                                                           | Description                                                                                                                                                                                                                                           | Repository                                                                                                     |
+|------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------|
+| [Shipwright](https://shipwright.io/)                                   | Shipwright is an extensible framework for building container images on Kubernetes.                                                                                                                                                                    | [https://github.com/shipwright-io](https://github.com/shipwright-io)                                           |
+| [Jenkins X](https://jenkins-x.io/)                                     | All In One CI/CD including everything you need to start exploring Kubernetes                                                                                                                                                                          | [github.com/jenkins-x](https://github.com/jenkins-x)                                                           |
+| kfp-tekton                                                             | Kubeflow Pipelines SDK for Tekton                                                                                                                                                                                                                     | [github.com/kubeflow/kfp-tekton](https://github.com/kubeflow/kfp-tekton/)                                      |
+| OpenShift Pipelines                                                    | OpenShift Pipelines is a cloud-native, continuous integration and continuous delivery (CI/CD) solution based on Kubernetes resources.                                                                                                                 | [github.com/openshift-pipelines](https://github.com/openshift-pipelines)                                       |
+| FRSCA                                                                  | OpenSSF's Factory for Repeatable Secure Creation of Artifacts (aka FRSCA pronounced Fresca) aims to help secure the supply chain by securing build pipelines.                                                                                         | [github.com/buildsec/frsca](https://github.com/buildsec/frsca)                                                 |
+| VSCode Tekton extension                                                | VSCode extension to manage Tekton resources.                                                                                                                                                                                                          | [github.com/redhat-developer/vscode-tekton](https://github.com/redhat-developer/vscode-tekton)                 |
+| JetBrains IDEs Tekton plugin                                           | JetBrains IDEs plugin to manage Tekton resources.                                                                                                                                                                                                     | [github.com/redhat-developer/intellij-tekton](https://github.com/redhat-developer/intellij-tekton)             |
+| Automatiko Approval task                                               | Brings approval tasks into Tekton pipeline with various strategies (single approval, multiple approvals, four eye based approval).                                                                                                                    | [github.com/automatiko-io/automatiko-approval-task](https://github.com/automatiko-io/automatiko-approval-task) |
+| [EPAM Delivery Platform (EDP)](https://epam.github.io/edp-install/)    | Cloud-agnostic SaaS/PaaS solution for software development with a pre-defined set of CI/CD pipelines and tools, enabling to kickstart development quickly with established processes for code review, release, versioning, branching, and deployment. | [github.com/epam/edp-tekton](https://github.com/epam/edp-tekton)                                               |
 
 
 ## Vendors
 
-| Company | How we use Tekton | Notes | May use logo in Tekton public presentations (optional) |
-|---------|-----------|---------|----------|
-| IBM | IBM offers Tekton as a Service through IBM Cloud Continuous Delivery Pipelines| [IBM Cloud Continuous Delivery](https://www.ibm.com/cloud/continuous-delivery)| Yes |
-| Google | Tekton is designed to work well with Google Cloud-specific Kubernetes tooling. This includes deployments to Google Kubernetes Engine as well as artifact storage and scanning using Container Registry. You can also build, test, and deploy across multiple environments such as VMs, serverless, Kubernetes, or Firebase.| [Tekton on Google Cloud](https://cloud.google.com/tekton)| Yes |
+| Company | How we use Tekton                                                                                                                                                                                                                                                                                                           | Notes                                                                          | May use logo in Tekton public presentations (optional) |
+|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------|--------------------------------------------------------|
+| IBM     | IBM offers Tekton as a Service through IBM Cloud Continuous Delivery Pipelines                                                                                                                                                                                                                                              | [IBM Cloud Continuous Delivery](https://www.ibm.com/cloud/continuous-delivery) | Yes                                                    |
+| Google  | Tekton is designed to work well with Google Cloud-specific Kubernetes tooling. This includes deployments to Google Kubernetes Engine as well as artifact storage and scanning using Container Registry. You can also build, test, and deploy across multiple environments such as VMs, serverless, Kubernetes, or Firebase. | [Tekton on Google Cloud](https://cloud.google.com/tekton)                      | Yes                                                    |
 
 
 
 ## End Users
 
-| Company | How we use Tekton | Notes | May use logo in Tekton public presentations (optional) |
-|---------|-----------|---------|----------|
-| IBM | Tekton is used as the basis of IBM Cloud's broadly adopted internal DevSecOps pipelines | | Yes |
-| Marriott Vacations Worldwide | All corporate CI/CD pipelines were migrated from Jenkins to Tekton, running on ROSA (RedHat Openshift Service on AWS) | | Yes |
-| Nubank | Tekton is the basis of the Nubank's primary CI/CD platform, supporting millions of builds per month | | Yes |
-| OneStock | Tekton is central to OneStock's CI/CD operations, managing 35+ different pipelines for 500+ repositories | | Yes |
+| Company                      | How we use Tekton                                                                                                     | Notes | May use logo in Tekton public presentations (optional) |
+|------------------------------|-----------------------------------------------------------------------------------------------------------------------|-------|--------------------------------------------------------|
+| IBM                          | Tekton is used as the basis of IBM Cloud's broadly adopted internal DevSecOps pipelines                               |       | Yes                                                    |
+| Marriott Vacations Worldwide | All corporate CI/CD pipelines were migrated from Jenkins to Tekton, running on ROSA (RedHat Openshift Service on AWS) |       | Yes                                                    |
+| Nubank                       | Tekton is the basis of the Nubank's primary CI/CD platform, supporting millions of builds per month                   |       | Yes                                                    |
+| OneStock                     | Tekton is central to OneStock's CI/CD operations, managing 35+ different pipelines for 500+ repositories              |       | Yes                                                    |
 
 ## Tekton Friends
 
 Meet more [Tekton friends](https://github.com/tektoncd/friends/)
 
 <p align="center">
-<img src="https://github.com/tektoncd/friends/raw/main/tekton-friends.png" alt="Tekton Friends logo (Tekton logo with rabbit and dog"></img>
+<img src="https://github.com/tektoncd/friends/raw/main/tekton-friends.png" alt="Tekton Friends logo (Tekton logo with rabbit and dog">
 </p>
diff --git a/governance.md b/governance.md
@@ -22,7 +22,7 @@ one year: every year either two or three of the seats are up for election.
 ### Current members
 
 | Full Name         |  Company   | GitHub                                      | Slack                                                         | Elected On | Until    |
-| ----------------- | :--------: | ------------------------------------------- | ------------------------------------------------------------- | ---------- | -------- |
+|-------------------|:----------:|---------------------------------------------|---------------------------------------------------------------|------------|----------|
 | Andrea Frittoli   |    IBM     | [afrittoli](https://github.com/afrittoli)   | [@Andrea Frittoli](https://tektoncd.slack.com/team/UJ411P2CC) | Feb 2022   | Feb 2024 |
 | Billy Lynch       | Chainguard | [wlynch](https://github.com/wlynch)         | [@Billy Lynch](https://tektoncd.slack.com/team/UJ7BLGSB0) .   | Feb 2023   | Feb 2024 |
 | Dibyo Mukherjee   |   Google   | [dibyom](https://github.com/dibyom)         | [@Dibyo Mukherjee](https://tektoncd.slack.com/team/UJ73HM7PZ) | Feb 2023   | Feb 2025 |
@@ -35,7 +35,7 @@ distributed across the five members of the committee.
 #### Former members ❤️
 
 | Full Name       | GitHub                                        | Slack                                                         | Elected On          | Until    |
-| --------------- | --------------------------------------------- | ------------------------------------------------------------- | ------------------- | -------- |
+|-----------------|-----------------------------------------------|---------------------------------------------------------------|---------------------|----------|
 | Priya Wadhwa    | [priyawadhwa](https://github.com/priyawadhwa) | [@Priya Wadhwa](https://tektoncd.slack.com/team/U02T0CS9PN0)  | Feb 2022            | Feb 2023 |
 | Christie Wilson | [bobcatfish](https://github.com/bobcatfish)   | [@Christie Wilson](https://tektoncd.slack.com/team/UJ6DECY78) | Bootstrap committee | Feb 2023 |
 | Andrew Bayer    | [abayer](https://github.com/abayer)           | [@Andrew Bayer](https://tektoncd.slack.com/team/UJ6DJ4MSS)    | Feb 2020            | Feb 2022 |
@@ -85,7 +85,7 @@ The committee is responsible for a series of specific artifacts and activities:
 
 - The [Code of Conduct](code-of-conduct.md) and handling violations
 - The [Project Communication Channels](contact.md)
-- The [Contribution Process](process.md) and
+- The [Contribution Process](./process/README.md) and
   [Development Standards](standards.md)
 - The [Tekton Mission and Vision](roadmap.md)
 - Select [election officers](#election-officers) to run elections
@@ -108,7 +108,7 @@ be altered or dropped.
 
 ### Voter Eligibility
 
-Anyone who has at least 15 [contributions](process.md#contributions) in the last
+Anyone who has at least 15 [contributions](./process/README.md#contributions) in the last
 12 months. The
 [dashboard on tekton.devstats.cd.foundation](https://tekton.devstats.cd.foundation/d/9/developer-activity-counts-by-repository-group-table?orgId=1&var-period_name=Last%20year&var-metric=contributions&var-repogroup_name=All&var-country_name=All)
 will show GitHub based contributions; contributions that are not GitHub based

diff --git a/org/README.md b/org/README.md
@@ -18,7 +18,7 @@ are a member of the tektoncd org or not!
 
 If you are regularly contributing to repos in tektoncd, then you can become a
 member of the Tekton GitHub organization in order to have tests run against your
-pull requests without requiring [`ok-to-test`](process.md#prow-commands).
+pull requests without requiring [`ok-to-test`](../process/README.md#prow-commands).
 Being part of the org also makes it possible to have issues assigned.
 
 To be eligible to become a member of the org you must (note that this is at the

diff --git a/process/README.md b/process/README.md
@@ -68,13 +68,13 @@ In general, you should follow the
 [Tekton Enhancement Proposals (`TEP`) process](./tep-process.md). A Tekton Enhancement
 Proposal (TEP) is a way to propose, communicate and coordinate on new efforts
 for the Tekton project. You can read the full details of the project in
-[TEP-1](./teps/0001-tekton-enhancement-proposal-process.md).
+[TEP-1](../teps/0001-tekton-enhancement-proposal-process.md).
 
 Some suggestions for how to do this:
 
 1. Write up a design doc and share it with
-   [the mailing list](contact.md#mailing-list).
-2. Bring your design/ideas to [our working group meetings](working-groups.md)
+   [the mailing list](../contact.md#mailing-list).
+2. Bring your design/ideas to [our working group meetings](../working-groups.md)
    for discussion.
 3. Write a [`TEP`](./tep-process.md) from the initial design doc and working group
    feedback.
@@ -87,7 +87,7 @@ A great proposal will include:
   yourself to brainstorm a couple more approaches may give you new ideas or make
   clear that your initial proposal is the best one
 
-Also feel free to reach out to us on [slack](contact.md#slack) if you want any
+Also feel free to reach out to us on [slack](../contact.md#slack) if you want any
 help/guidance.
 
 Thanks so much!!
@@ -110,7 +110,7 @@ See our [contributor ladder](./contributor-ladder.md) for more information.
 ## Reviews
 
 Reviewers will be auto-assigned by [Prow](#pull-request-process) from the
-[OWNERS](#OWNERS), which acts as suggestions for which `OWNERS` should review
+[OWNERS](../OWNERS), which acts as suggestions for which `OWNERS` should review
 the PR. (OWNERS, your review requests can be viewed at
 [https://github.com/pulls/review-requested](https://github.com/pulls/review-requested)).
 
@@ -146,7 +146,7 @@ Before a PR can be merged, it must have both `/lgtm` AND `/approve`:
 - `/lgtm` can be added by
   ["Reviewers"](https://github.com/tektoncd/community/blob/main/process.md#reviewer), aka anyone in
   Reviewer team specific to the repo
-- `/approve` can be added only by [OWNERS](#owners)
+- `/approve` can be added only by [OWNERS](../OWNERS)
 
 The merge will happen automatically once the PR has both `/lgtm` and `/approve`,
 and all tests pass. If you don't want this to happen you should
@@ -199,7 +199,7 @@ individual CLA or indicate your affilation with a company that has signed it
 part of the company, for example often this is managed via the domain your email
 address).
 
-Members of [the governing board](governance.md) are authorized to administer the
+Members of [the governing board](../governance.md) are authorized to administer the
 CDF CLA via the website and can control which repos it is applied to.
 
 ## Postmortems