Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix broken documentation links #59

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions frontend/src/components/page/Footer.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -76,19 +76,19 @@ const Footer: React.FC<FooterProps> = ({ history, visible, ...props }) => (
<h4 className="oh-footer__contents-right__links__list__header">NETWORK</h4>
<ExternalLink
className="oh-footer__contents-right__links__list__link"
href={documentationLinks.hubTwitter}
text="Twitter"
href={documentationLinks.socialHubX}
text="X (Twitter)"

/>
<ExternalLink
className="oh-footer__contents-right__links__list__link"
href={documentationLinks.hubYoutube}
href={documentationLinks.socialHubYoutube}
text="YouTube"

/>
<ExternalLink
className="oh-footer__contents-right__links__list__link"
href={documentationLinks.operatorsFramework}
href={documentationLinks.operatorsFrameworkRepo}
text="GitHub"

/>
Expand All @@ -100,7 +100,7 @@ const Footer: React.FC<FooterProps> = ({ history, visible, ...props }) => (
/>
<ExternalLink
className="oh-footer__contents-right__links__list__link"
href={documentationLinks.kubernetesSlack}
href={documentationLinks.socialKubernetesSlack}
text="Join us on Slack"

/>
Expand Down
4 changes: 2 additions & 2 deletions frontend/src/pages/documentation/GettingStarted.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ import { ExternalLink } from '../../components/ExternalLink';
import DocumentationPage from '../../components/page/DocumentationPage';
// @ts-ignore
import maturityDetailsImg from '../../imgs/capability-level-diagram.svg';
import { operatorSdk, gettingStarted, operatorsFramework } from '../../utils/documentationLinks';
import { operatorSdk, gettingStarted, operatorsFrameworkRepo } from '../../utils/documentationLinks';
import { InternalLink } from '../../components/InternalLink';
import { History } from 'history';

Expand Down Expand Up @@ -116,7 +116,7 @@ const GettingStarted: React.FC<GettingStartedPageProps> = ({ history, ...props }
</p>
<p>
Fortunately there is the <ExternalLink href={operatorSdk} text="operator-sdk" />, part of
the <ExternalLink href={operatorsFramework} text="Operator Framework" />, a community project that
the <ExternalLink href={operatorsFrameworkRepo} text="Operator Framework" />, a community project that
aims at simplifying the whole process of Operator creation to just writing the custom operational logic
inside the control loop.
</p>
Expand Down
61 changes: 33 additions & 28 deletions frontend/src/utils/documentationLinks.ts
Original file line number Diff line number Diff line change
@@ -1,37 +1,42 @@
export const operatorsFramework = 'https://github.com/k8s-operatorhub';
export const operatorsRepo = `${operatorsFramework}/community-operators`;
export const gettingStarted = `https://operatorframework.io`;
export const sdkQuickstartBundle = `https://sdk.operatorframework.io/docs/olm-integration/quickstart-bundle/`;
export const manageOperatorWithOlm = `https://olm.operatorframework.io`;
export const introBlog = `https://www.redhat.com/en/blog/introducing-operators-putting-operational-knowledge-into-software`;
export const privacyPolicy = `https://www.redhat.com/en/about/privacy-policy`;
export const semanticVersioning = `https://semver.org/`;
export const socialHubX = `https://x.com/operatorhubio`;
export const socialHubYoutube = 'https://www.youtube.com/watch?v=yzPvPJLxCl8&list=PLaR6Rq6Z4Iqcuu758T4YX6KRa1158v3Rb';
export const socialKubernetesSlack = `https://kubernetes.slack.com/messages/kubernetes-operators`;

export const operatorsDocumentation = `https://k8s-operatorhub.github.io/community-operators`
export const contributions = `${operatorsRepo}/tree/main/operators`;
export const operatorsRepo = `https://github.com/k8s-operatorhub/community-operators`;
export const operatorsFrameworkRepo = 'https://github.com/operator-framework';

export const operatorsRepoBeforePR = `${operatorsDocumentation}/contributing-prerequisites`;
export const operatorsRepoRequirements = `${operatorsDocumentation}/packaging-operator`;
export const operatorSdk = `${operatorsFramework}/operator-sdk`;
export const sdkQuickstartBundle = `https://sdk.operatorframework.io/docs/olm-integration/quickstart-bundle/`;
export const operatorCourier = `${operatorsFramework}/operator-courier`;
export const operatorScorecard = `${operatorSdk}/blob/master/doc/test-framework/scorecard.md`;
export const operatorBundle = `${operatorsRepo}#adding-your-operator`;
export const olm = `${operatorsFramework}/operator-lifecycle-manager`;
export const gettingStarted = `https://operatorframework.io`;
export const operatorRegistry = `${operatorsFramework}/operator-registry`;
export const bundleAnnotations = `${operatorsFramework}/operator-registry/blob/master/docs/design/operator-bundle.md#bundle-annotations`;
export const bundleDockerfile = `${operatorsFramework}/operator-registry/blob/master/docs/design/operator-bundle.md#bundle-dockerfile`;
export const operatorBundle = `${operatorsDocumentation}#add-your-operator`;
export const manualTestingOnKubernetes = `${operatorsDocumentation}/operator-test-suite`;
export const operatorMetadataValidation = `${operatorsDocumentation}/testing-operators`;
export const prometheusOperator = `${contributions}/prometheus`;
export const prometheusOperatorVersion = `${contributions}/prometheus/0.22.2`;
export const olmArchitecture = `${olm}/blob/master/doc/design/architecture.md`;
export const buildYourCSV = `${operatorsDocumentation}/packaging-operator`;
export const createPackageManifest = `${operatorsDocumentation}/packaging-operator`;
export const semanticVersioning = `https://semver.org/`;
export const createBundle = `${operatorsRepo}/blob/master/docs/contributing.md#create-a-release-using-the-bundle-format`;
export const packagemanifestToBundle = `${operatorsDocumentation}/packaging-operator`;
export const discoveryCatalogs = `${olm}#discovery-catalogs-and-automated-upgrades`;
export const introBlog = `https://web.archive.org/web/20170129131616/https://coreos.com/blog/introducing-operators.html`;
export const sampleCode = `${operatorsFramework}/operator-sdk/blob/master/testdata/go/v3/memcached-operator/controllers/memcached_controller.go#L51-L137`;
export const createBundle = `${operatorsDocumentation}/packaging-operator/#package-your-operator`;
export const packagemanifestToBundle = `${operatorsDocumentation}/packaging-operator/#moving-from-packagemanifest-to-bundle-format`;

export const contributions = `${operatorsRepo}/tree/main/operators`;
export const fileAnIssue = `${operatorsRepo}/issues`;

export const operatorCourier = `${operatorsFrameworkRepo}/operator-courier`;

export const operatorRegistry = `${operatorsFrameworkRepo}/operator-registry`;
export const bundleAnnotations = `${operatorRegistry}/blob/master/docs/design/operator-bundle.md#bundle-annotations`;
export const bundleDockerfile = `${operatorRegistry}/blob/master/docs/design/operator-bundle.md#bundle-dockerfile`;

export const operatorSdk = `${operatorsFrameworkRepo}/operator-sdk`;
export const operatorScorecard = `${operatorSdk}/blob/master/doc/test-framework/scorecard.md`;
export const capabilityLevelModelDiagram = `${operatorSdk}/blob/master/doc/images/operator-capability-level.png`;
export const manageOperatorWithOlm = `https://olm.operatorframework.io`;
export const sampleCode = `${operatorSdk}/tree/master/testdata/go/v4/memcached-operator/internal/controller/memcached_controller.go#L81-L283`;

export const olm = `${operatorsFrameworkRepo}/operator-lifecycle-manager`;
export const olmArchitecture = `${olm}/blob/master/doc/design/architecture.md`;
export const operatorGroupDesign = `${olm}/blob/master/doc/design/architecture.md#operator-group-design`;
export const privacyPolicy = `https://www.redhat.com/en/about/privacy-policy`;
export const kubernetesSlack = `https://kubernetes.slack.com/messages/kubernetes-operators`;
export const hubTwitter = `https://twitter.com/operatorhubio`;
export const hubYoutube = 'https://www.youtube.com/watch?v=yzPvPJLxCl8&list=PLaR6Rq6Z4Iqcuu758T4YX6KRa1158v3Rb';
export const fileAnIssue = `${operatorsRepo}/issues`;
export const discoveryCatalogs = `${olm}#discovery-catalogs-and-automated-upgrades`;