diff --git a/develop-docs/getting-started/index.mdx b/develop-docs/getting-started/index.mdx index 799d8388fa88c..fc4578de1028f 100644 --- a/develop-docs/getting-started/index.mdx +++ b/develop-docs/getting-started/index.mdx @@ -4,15 +4,10 @@ description: This documentation serves as reference points for developing agains sidebar_order: 1 --- -## Getting Started +We recommend going through the [engineering practices](/engineering-practices) and our [development philsophy](/getting-started/philosophy/) before contributing a change to Sentry. -We recommend going through the general documentation before contributing a change to Sentry. -- Development Philosophy (and SDK Development Philosophy) -- Commit Messages -- Code Review -- Environment -- Workflow -- Application Architecture + + You can also take a glance at the [Sentry Dockerfile](https://github.com/getsentry/sentry/blob/master/self-hosted/Dockerfile) for more information on how the Sentry server is configured, including its system dependencies. diff --git a/src/components/card.tsx b/src/components/card.tsx index db5687f275f35..b17746da26ed1 100644 --- a/src/components/card.tsx +++ b/src/components/card.tsx @@ -19,11 +19,16 @@ export function Card({ }) { return ( -
- {imageAlt} +
+ {imageAlt}

{title}

-

{description}

+

{description}

diff --git a/src/components/devDocsCardGrid.tsx b/src/components/devDocsCardGrid.tsx new file mode 100644 index 0000000000000..e999b7f6baa60 --- /dev/null +++ b/src/components/devDocsCardGrid.tsx @@ -0,0 +1,82 @@ +import BackendImg from 'sentry-docs/imgs/back-end.png'; +import InfraImg from 'sentry-docs/imgs/dev-infra.png'; +import FrontendImg from 'sentry-docs/imgs/front-end.png'; +import IngestImg from 'sentry-docs/imgs/ingest.png'; +import IntegrationsImg from 'sentry-docs/imgs/integrate.png'; +import SkdsImg from 'sentry-docs/imgs/sdks.png'; +import ServicesImg from 'sentry-docs/imgs/services.png'; +import SelfHostedImg from 'sentry-docs/imgs/support.png'; + +import {Card} from './card'; + +export function DevDocsCardGrid() { + return ( +
+ + + + + + + + + +
+ ); +} diff --git a/src/components/docPage/type.scss b/src/components/docPage/type.scss index 5ba6cf1d2af91..87c70ea1b40b1 100644 --- a/src/components/docPage/type.scss +++ b/src/components/docPage/type.scss @@ -78,7 +78,7 @@ margin-bottom: 1.75rem; } - h3 { + h3 :not(.not-prose) { font-size: 1.125rem; } diff --git a/src/imgs/back-end.png b/src/imgs/back-end.png new file mode 100644 index 0000000000000..de7dfb7a7c0a0 Binary files /dev/null and b/src/imgs/back-end.png differ diff --git a/src/imgs/dev-infra.png b/src/imgs/dev-infra.png new file mode 100644 index 0000000000000..d43e3478df5d2 Binary files /dev/null and b/src/imgs/dev-infra.png differ diff --git a/src/imgs/front-end.png b/src/imgs/front-end.png new file mode 100644 index 0000000000000..22fcd91b43601 Binary files /dev/null and b/src/imgs/front-end.png differ diff --git a/src/imgs/ingest.png b/src/imgs/ingest.png new file mode 100644 index 0000000000000..af1e8ff06f3bb Binary files /dev/null and b/src/imgs/ingest.png differ diff --git a/src/imgs/integrate.png b/src/imgs/integrate.png new file mode 100644 index 0000000000000..d70865dc11754 Binary files /dev/null and b/src/imgs/integrate.png differ diff --git a/src/imgs/sdks.png b/src/imgs/sdks.png new file mode 100644 index 0000000000000..d95ea68d3400c Binary files /dev/null and b/src/imgs/sdks.png differ diff --git a/src/imgs/services.png b/src/imgs/services.png new file mode 100644 index 0000000000000..9f5b6b0cac97e Binary files /dev/null and b/src/imgs/services.png differ diff --git a/src/mdxComponents.ts b/src/mdxComponents.ts index f22c2e0214382..39da4ba80710e 100644 --- a/src/mdxComponents.ts +++ b/src/mdxComponents.ts @@ -1,6 +1,7 @@ import {Alert} from './components/alert'; import {Arcade} from './components/arcade'; import {Break} from './components/break'; +import {Card} from './components/card'; import {CliChecksumTable} from './components/cliChecksumTable'; import {CodeBlock} from './components/codeBlock'; import {CodeTabs} from './components/codeTabs'; @@ -9,6 +10,7 @@ import {ConfigKey} from './components/configKey'; import {ConfigValue} from './components/configValue'; import {CreateGitHubAppForm} from './components/createGitHubAppForm'; import {DefinitionList} from './components/definitionList'; +import {DevDocsCardGrid} from './components/devDocsCardGrid'; import DocImage from './components/docImage'; import {Expandable} from './components/expandable'; import {GuideGrid} from './components/guideGrid'; @@ -43,8 +45,10 @@ export function mdxComponents( Alert, Arcade, Break, + Card, CliChecksumTable, CommunitySupportedPlatforms, + DevDocsCardGrid, PlatformFilter, CodeBlock, CodeTabs,