Skip to content

feat(get-started): add Get started and First deploy pages - #2296

Open
marcus-souza-azion wants to merge 1 commit into
mainfrom
feat/get-started-pages
Open

feat(get-started): add Get started and First deploy pages#2296
marcus-souza-azion wants to merge 1 commit into
mainfrom
feat/get-started-pages

Conversation

@marcus-souza-azion

@marcus-souza-azion marcus-souza-azion commented Jul 31, 2026

Copy link
Copy Markdown

What & why

Adds a new Get started section — a landing page plus a First deploy tutorial (EN/PT) — giving the docs a single entry point that takes a visitor from zero to a deployed application in a few minutes. Foundation PR: the docs-home redesign and the new sidebar both link to these pages.

Related issue: NO-ISSUE
Pages affected:

  • /documentation/get-started/ (new)
  • /documentation/get-started/first-deploy/ (new)
  • /documentacao/get-started/ (new)
  • /documentacao/get-started/first-deploy/ (new)
  • src/components/DocsCard.astro (new — card component these pages use)

Type of change

  • 🆕 New content (feat) — built from a content template
  • 🩹 Fix (fix) — typo, broken link, wrong information
  • ♻️ Content update (docs) — rewrite, expansion, upkeep
  • 🌐 Translation sync (i18n)
  • 🏗️ Platform / structure (refactor / chore) — UXE review, no content mixed in

Author checklist

  • PR title follows type(scope): summary (GOVERNANCE §4)
  • Frontmatter complete: title, description, meta_tags, namespace, permalink (last_reviewed is not part of this repo's schema)
  • Style guide followed — no legacy "edge-" product names
  • How-to/tutorial includes ≥1 runnable, copy-paste-tested code block (curl verification + Azion CLI install/link/deploy)
  • Screenshots (if any) have alt text — n/a, no in-content screenshots
  • Internal links are relative and resolve locally (lint:linkcheck: zero issues)
  • Permalink changed or page moved → redirect included in this PR — n/a, net-new pages only
  • i18n: pt-br updated here — all four files mirrored
  • npm run build:local passes (build + frontmatter) — ran as astro build + npm run test:frontmatter to avoid the src/consts.ts swap build:local performs

Reviewer checklist

  • Technically accurate (SME, if technical claims changed)
  • Right place in the IA; discoverable from the relevant journey
  • Reads at the level of surrounding docs (editorial)

Notes for reviewers

  • All internal links point at existing production pages; lint:linkcheck passes with zero broken links.
  • DocsCard.astro is a hard build dependency of these pages, ported together with them. Its azion-webkit card imports are cast to keep astro check clean (the webkit .d.ts files omit pass-through props).
  • astro check/tsc fail on main today (141/78 pre-existing errors in src/i18n/* and a test file). This PR adds zero new errors — verified against a pristine-main baseline.
  • These pages have no menu_namespace, so they render on the existing default sidebar; the redesigned sidebar arrives in a follow-up PR.

First Deploy Screen:

pr1a-first-deploy

Get Started Screen:

pr1a-get-started-landing

@isaque-bock-azion

isaque-bock-azion commented Jul 31, 2026

Copy link
Copy Markdown

Nao sei se a abordagem correta é encapsular componente na docs, tendo em vista que temos o Webkit para servir nossos artefatos de UI. Entender que um efeito disso é a complexidade de adaptacao do design system nesse frontend posteriormente.

cc: @egermano

Comment thread src/components/DocsCard.astro Outdated
Port the new Get started landing and First deploy tutorial (en/pt-br)
from the IA revamp as net-new pages on the production IA. All internal
links retargeted to existing production permalinks via frontmatter
namespace joins, cross-checked against the migration de-para map.

Includes src/components/DocsCard.astro, the card component the pages
import (webkit card imports cast to keep astro check clean).
@marcus-souza-azion

Copy link
Copy Markdown
Author

Nao sei se a abordagem correta é encapsular componente na docs, tendo em vista que temos o Webkit para servir nossos artefatos de UI. Entender que um efeito disso é a complexidade de adaptacao do design system nesse frontend posteriormente.

cc: @egermano

A intenção aqui foi poder alterar essencialmente o tamanho do card e alguns elementos sem precisar solicitar ao webkit e ao mesmo tempo usar o webkit como base: nosso card tem dimenções ao redor de 600x200+(não é o numero exato), e o problema disso é que ele ocupa muito espaco na pagina. Eu quis trazer uma dimensão para esses cards conforme padrões de mercado que ficam mais ou menos ali entre 300x150, pois isso faz o usuário ter um melhor aproveitamento de tela, scrollar menos, etc. Ao mesmo tempo, não queria ter que solicitar mudança ou adição de componente ao webkit só pra trazer isso, por isso optei por fazer o wrapper ao redor do componente do webkit.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants