AZPrototype/index.html at main · Bird-NZ/AZPrototype · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Teach people to go from idea to Azure prototype · AZPrototype</title>
  <meta name="description" content="A polished product-docs style site for learning AZ Prototype: install it, run it, customize it, and ship with confidence.">
  <link rel="stylesheet" href="assets/style.css">
  <script defer src="assets/site.js"></script>
</head>
<body>
  <div class="shell">
    <aside class="sidebar">
      <a class="brand" href="index.html">
        <span class="brand-mark">AZ</span>
        <span><strong>AZPrototype</strong><small>GitHub Pages docs site</small></span>
      </a>
      <nav class="nav"><a href="index.html" class="nav-link active">Overview</a><a href="getting-started.html" class="nav-link">Getting started</a><a href="quickstart.html" class="nav-link">Quickstart</a><a href="walkthrough.html" class="nav-link">Walkthrough</a><a href="artifacts.html" class="nav-link">Artifacts</a><a href="agents.html" class="nav-link">Agents</a><a href="templates.html" class="nav-link">Templates</a><a href="configuration.html" class="nav-link">Configuration</a><a href="deployment.html" class="nav-link">Deployment</a><a href="troubleshooting.html" class="nav-link">Troubleshooting</a><a href="examples.html" class="nav-link">Examples</a><a href="faq.html" class="nav-link">FAQ</a></nav>
      <div class="sidebar-note">
        <p><strong>Workflow</strong></p>
        <p><code>init → design → build → deploy</code></p>
      </div>
    </aside>
    <main class="content">
      <header class="hero">
        <p class="eyebrow">AZ Prototype Docs</p>
        <h1>Teach people to go from idea to Azure prototype</h1>
        <p class="lede">A polished product-docs style site for learning AZ Prototype: install it, run it, customize it, and ship with confidence.</p>
        <div class="hero-actions"><a class="btn primary" href="getting-started.html">Start with prerequisites</a><a class="btn ghost" href="quickstart.html">Run the quickstart</a></div>
      </header>

<section class="grid cols-3">
  <article class="card"><h3>Start fast</h3><p>Install the extension, check prerequisites, and run a first project in minutes.</p></article>
  <article class="card"><h3>Learn the workflow</h3><p>Understand what each stage does, when it is re-entrant, and how agents collaborate.</p></article>
  <article class="card"><h3>Deploy safely</h3><p>Use dry-runs, inspect staged outputs, and troubleshoot failed deployments without guessing.</p></article>
</section>
<section class="grid cols-2">
  <article class="panel"><h2>What AZ Prototype is</h2><p><code>az prototype</code> is an Azure CLI extension that turns requirements into an Azure prototype through a structured four-stage flow: <strong>init</strong>, <strong>design</strong>, <strong>build</strong>, and <strong>deploy</strong>.</p><ul><li>Supports GitHub Copilot, GitHub Models, and Azure OpenAI</li><li>Uses a built-in team of specialized agents</li><li>Generates Terraform or Bicep plus application code and docs</li><li>Helps with architecture, governance, QA, monitoring, and cost analysis</li></ul></article>
  <article class="panel accent"><h2>Recommended learning path</h2><ol><li>Read <a href="getting-started.html">Getting started</a></li><li>Run the <a href="quickstart.html">Quickstart</a></li><li>Follow the full <a href="walkthrough.html">Init → Design → Build → Deploy walkthrough</a></li><li>Customize with <a href="templates.html">templates</a> and <a href="configuration.html">prototype.yaml</a></li><li>Use <a href="deployment.html">deployment and dry-run guidance</a> before real Azure rollout</li></ol></article>
</section>
<section class="panel">
  <h2>Core documentation areas</h2>
  <div class="grid cols-2 compact">
    <a class="topic" href="getting-started.html"><strong>Getting started</strong><span>Installation, prerequisites, first-run checks</span></a>
    <a class="topic" href="quickstart.html"><strong>Quickstart</strong><span>First usable project with copy-paste commands</span></a>
    <a class="topic" href="walkthrough.html"><strong>Walkthrough</strong><span>The full stage-by-stage tutorial</span></a>
    <a class="topic" href="artifacts.html"><strong>Artifacts</strong><span>What to put in <code>--artifacts</code> and real sample files</span></a><a class="topic" href="agents.html"><strong>Agents overview</strong><span>Who does what inside the system</span></a>
    <a class="topic" href="templates.html"><strong>Templates</strong><span>Workload starting points and when to use them</span></a>
    <a class="topic" href="configuration.html"><strong>Configuration</strong><span>How to shape <code>prototype.yaml</code></span></a>
    <a class="topic" href="deployment.html"><strong>Deployment</strong><span>Dry-run, staged rollout, outputs, rollback</span></a>
    <a class="topic" href="troubleshooting.html"><strong>Troubleshooting</strong><span>Common failures and the shortest path out</span></a>
    <a class="topic" href="examples.html"><strong>Demo scripts</strong><span>Repeatable examples for demos and workshops</span></a>
    <a class="topic" href="faq.html"><strong>FAQ</strong><span>Common operator and onboarding questions</span></a>
  </div>
</section>
<section class="panel accent"><h2>New: reusable scenario packs</h2><p>The docs site now includes sample artifact packs for <strong>AI app</strong>, <strong>data platform</strong>, <strong>internal copilot</strong>, and <strong>app modernization</strong> demos — plus a general mixed-format starter pack.</p><div class="hero-actions"><a class="btn primary" href="artifacts.html">Browse artifacts</a><a class="btn ghost" href="examples.html">Use scenario examples</a></div></section>
<section class="panel">
  <h2>Who this site is for</h2>
  <p>This site is aimed at solution engineers, prototype builders, cloud architects, and technical sellers who want to move from a vague customer request to something concrete in Azure without assembling the whole workflow by hand.</p>
</section>

      <footer class="footer">
        <p>Built as a static, GitHub Project Pages-ready site for the <code>az prototype</code> extension.</p>
      </footer>
    </main>
  </div>
</body>
</html>