Skip to content

[docs][ux] QUICKSTART_WINDOWS separado (non-techie, passo-a-passo) — do guia validado com 1º usuário #1128

Closed

Description

@FabioLeitao

Contexto

1º usuário real non-techie (Windows) validou a instalação via pipx — e cada tropeço dele lapidou um guia passo-a-passo à prova de leigo. Guia pronto no vault: databoar-commercial/GUIA_data-boar-windows-demo.md (Cursor tem acesso ao vault).

Estrutura (recomendação): Windows quickstart SEPARADO

  • docs/QUICKSTART_WINDOWS.md = o guia non-techie completo (hand-holding).
  • README / quickstart geral = TERSE (Linux/Mac/dev: pipx install data-boar) + pointer PROEMINENTE: "🪟 No Windows e nunca fez isso? → docs/QUICKSTART_WINDOWS.md".
  • Motivo: non-techie precisa de hand-holding; dev quer o terse. Docs diferentes, cross-linked.

AC

  • Criar docs/QUICKSTART_WINDOWS.md a partir do guia do vault (conteúdo JÁ validado — não reescrever a lógica, só adaptar tom).
  • Pointer proeminente no README apontando pro Windows-quickstart; geral fica terse.
  • Adaptar tom pra repo PÚBLICO: "me chama"/"me avisa"/"manda foto" → "abra uma issue" / "fale com a gente" (amigável, não suporte-pessoal).
  • Verificar refs: Docker Hub (data_boar:latest), URLs, github.com/DataBoar/data-boar.
  • Preservar o conteúdo validado: flow winget (PowerShell-built-in → winget Terminal+Python-3.12 → Windows Terminal) · regra terminal-vs->>> · avisos-amarelos-normais · --demo antes do --web · URL-limpa/navegador/pt-br-opcional · atalho-ícone · nota Win10/11 vs Win7.

Notas

Feedback origem: #1126 (guia UX) + #1127 (--install-shortcut). Endgame = MS Store (MSIX); este quickstart cobre o "hoje" (pipx). O mesmo conteúdo vai TAMBÉM pro site (renderizado) — tarefa separada.

Activity

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions