infrasketch 2.0.0__tar.gz → 2.1.0__tar.gz

{infrasketch-2.0.0/src/infrasketch.egg-info → infrasketch-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: infrasketch
-Version: 2.0.0
+Version: 2.1.0
 Summary: Draw Azure and AWS architecture diagrams as SVG with official resource icons. No Graphviz.
 Author: infrasketch
 License-Expression: MIT AND LicenseRef-Microsoft-Azure-Architecture-Icons AND LicenseRef-AWS-Architecture-Icons
@@ -120,10 +120,26 @@ diagram.save("orders.svg")
 | `a >> Https() >> b` | Azure-blue HTTPS |
 | `a >> Async("enqueue") >> b` | Dashed queue or event |
 | `a >> Private() >> b` | Dashed Private Link |
+| `a >> Https("Open the store", 1) >> b` | Numbered step. The sentence is listed under the drawing |
 
 `style` is `"solid"`, `"dashed"`, or `"dotted"`. `color` is a hex color such
 as `"#0078D4"`.
 
+A resource can carry the design decision and a link. The SKU, region, and
+exposure are a second caption. `note` is the line under that. `href` makes the
+icon a link. The same fields, except `href`, work on a group:
+
+```python
+api = AppService(
+    "Orders API",
+    sku="P1v3",
+    region="West Europe",
+    public=False,
+    note="Private endpoint only",
+    href="https://learn.microsoft.com/azure/app-service/overview",
+)
+```
+
 ## Boundaries
 
 | Group | Use it for |
@@ -192,6 +208,8 @@ to use your own artwork. Azure icons are never recoloured or stretched.
 | `examples/aws_orders.py` | CloudFront, API Gateway, Lambda, DynamoDB, and S3 in a VPC |
 | `examples/aws_eks.py` | EKS, a registry, ElastiCache, and RDS |
 | `examples/aws_events.py` | API Gateway, Lambda, SQS, DynamoDB, and S3 |
+| `examples/azure_decisions.py` | SKU, exposure, notes, numbered steps, and links |
+| `examples/aws_decisions.py` | The same decisions on an AWS drawing |
 
 ![Web, API, and Redis](examples/out/azure-web-api.svg)
 

{infrasketch-2.0.0 → infrasketch-2.1.0}/README.md

@@ -101,10 +101,26 @@ diagram.save("orders.svg")
 | `a >> Https() >> b` | Azure-blue HTTPS |
 | `a >> Async("enqueue") >> b` | Dashed queue or event |
 | `a >> Private() >> b` | Dashed Private Link |
+| `a >> Https("Open the store", 1) >> b` | Numbered step. The sentence is listed under the drawing |
 
 `style` is `"solid"`, `"dashed"`, or `"dotted"`. `color` is a hex color such
 as `"#0078D4"`.
 
+A resource can carry the design decision and a link. The SKU, region, and
+exposure are a second caption. `note` is the line under that. `href` makes the
+icon a link. The same fields, except `href`, work on a group:
+
+```python
+api = AppService(
+    "Orders API",
+    sku="P1v3",
+    region="West Europe",
+    public=False,
+    note="Private endpoint only",
+    href="https://learn.microsoft.com/azure/app-service/overview",
+)
+```
+
 ## Boundaries
 
 | Group | Use it for |
@@ -173,6 +189,8 @@ to use your own artwork. Azure icons are never recoloured or stretched.
 | `examples/aws_orders.py` | CloudFront, API Gateway, Lambda, DynamoDB, and S3 in a VPC |
 | `examples/aws_eks.py` | EKS, a registry, ElastiCache, and RDS |
 | `examples/aws_events.py` | API Gateway, Lambda, SQS, DynamoDB, and S3 |
+| `examples/azure_decisions.py` | SKU, exposure, notes, numbered steps, and links |
+| `examples/aws_decisions.py` | The same decisions on an AWS drawing |
 
 ![Web, API, and Redis](examples/out/azure-web-api.svg)
 

{infrasketch-2.0.0 → infrasketch-2.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "infrasketch"
-version = "2.0.0"
+version = "2.1.0"
 description = "Draw Azure and AWS architecture diagrams as SVG with official resource icons. No Graphviz."
 readme = "README.md"
 requires-python = ">=3.10"

{infrasketch-2.0.0 → infrasketch-2.1.0}/src/infrasketch/layout.py

@@ -67,13 +67,21 @@ def layout_scope(scope: Diagram | Group) -> None:
 def measure_node(node: Node) -> None:
     node.label_lines = wrap(node.label, LABEL_SIZE, TEXT_MAX)[:3]
     node.caption_lines = wrap(node.caption, CAPTION_SIZE, TEXT_MAX)[:2] if node.caption else []
+    node.detail_lines = wrap(node.facts(), CAPTION_SIZE, TEXT_MAX)[:2]
+    node.note_lines = wrap(node.note, CAPTION_SIZE, TEXT_MAX)[:2]
     widths = [text_width(line, LABEL_SIZE) for line in node.label_lines]
     widths += [text_width(line, CAPTION_SIZE) for line in node.caption_lines]
+    widths += [text_width(line, CAPTION_SIZE) for line in node.detail_lines]
+    widths += [text_width(line, CAPTION_SIZE) for line in node.note_lines]
     text_w = max(widths) if widths else 0.0
     node.w = max(ICON + 20.0, text_w + 12.0)
     text_h = len(node.label_lines) * LABEL_LEADING
     if node.caption_lines:
         text_h += 3.0 + len(node.caption_lines) * CAPTION_LEADING
+    if node.detail_lines:
+        text_h += len(node.detail_lines) * CAPTION_LEADING
+    if node.note_lines:
+        text_h += 2.0 + len(node.note_lines) * CAPTION_LEADING
     node.h = ICON + ICON_TEXT_GAP + text_h
     node.icon_box = ((node.w - ICON) / 2.0, 0.0, ICON, ICON)
 
@@ -81,7 +89,7 @@ def measure_node(node: Node) -> None:
 def apply_chrome(group: Group) -> None:
     style = BOUNDARIES[group.kind]
     spacing = SPACING[group.diagram.spacing]
-    header = measure_header(group.label, style)
+    header = measure_header(group.label, style, detail=group.facts(), note=group.note)
     group.header = header
     group.header_h = header["height"]
     pad = spacing["pad"]
@@ -93,18 +101,32 @@ def apply_chrome(group: Group) -> None:
     group.h = group.content_y + group.content_h + pad
 
 
-def measure_header(label: str, style: dict) -> dict:
+def measure_header(label: str, style: dict, detail: str = "", note: str = "") -> dict:
     title_lines = wrap(label, 13.5, 240.0)[:2] or [label]
+    detail_lines = wrap(detail, 11.0, 240.0)[:2] if detail else []
+    note_lines = wrap(note, 11.0, 240.0)[:2] if note else []
     title_w = max(text_width(line, 13.5) for line in title_lines)
+    detail_w = max((text_width(line, 11.0) for line in detail_lines), default=0.0)
+    note_w = max((text_width(line, 11.0) for line in note_lines), default=0.0)
     eyebrow = style["eyebrow"]
     eye_w = text_width(eyebrow, 10.0) * 1.18 if eyebrow else 0.0
     icon_slot = 28.0 if style["icon"] else 0.0
-    width = 16.0 + icon_slot + max(title_w, eye_w) + 18.0
+    width = 16.0 + icon_slot + max(title_w, eye_w, detail_w, note_w) + 18.0
     if eyebrow:
         height = 14.0 + 13.0 + len(title_lines) * 16.0 + 8.0
     else:
         height = 10.0 + len(title_lines) * 18.0 + 10.0
-    return {"height": height, "width": width, "title_lines": title_lines, "eyebrow": eyebrow}
+    extra = (len(detail_lines) + len(note_lines)) * 14.0
+    if extra:
+        height += extra + 2.0
+    return {
+        "height": height,
+        "width": width,
+        "title_lines": title_lines,
+        "eyebrow": eyebrow,
+        "detail_lines": detail_lines,
+        "note_lines": note_lines,
+    }
 
 
 def place_flow(scope: Diagram | Group) -> None:

{infrasketch-2.0.0 → infrasketch-2.1.0}/src/infrasketch/model.py

@@ -47,6 +47,23 @@ class Endpoint(Scope):
     """Something an arrow can connect to: a resource or a boundary."""
 
     label = ""
+    sku = ""
+    region = ""
+    public: bool | None = None
+    note = ""
+
+    def facts(self) -> str:
+        """SKU, region, and exposure, joined for the second caption."""
+        parts = []
+        if self.sku:
+            parts.append(self.sku)
+        if self.region:
+            parts.append(self.region)
+        if self.public is True:
+            parts.append("Public")
+        elif self.public is False:
+            parts.append("Private")
+        return " · ".join(parts)
 
     def __repr__(self) -> str:
         return f"{type(self).__name__}({self.label!r})"
@@ -75,6 +92,7 @@ class Endpoint(Scope):
                 color=edge.color,
                 style=edge.style or "solid",
                 direction=direction,
+                number=edge.number,
             )
         )
         return other
@@ -145,6 +163,7 @@ class Connection:
     color: str = ""
     style: str = "solid"
     direction: str = "forward"
+    number: int | None = None
     points: list[tuple[float, float]] = field(default_factory=list)
     lane: float = 0.0
 
@@ -155,6 +174,7 @@ class Edge:
     def __init__(
         self,
         label: str = "",
+        number: int | None = None,
         *,
         color: str = "",
         style: str = "solid",
@@ -163,6 +183,7 @@ class Edge:
         node: Endpoint | None = None,
     ) -> None:
         self.label = label or ""
+        self.number = _check_number(number)
         self.color = color or ""
         self.style = style or "solid"
         self.forward = forward
@@ -197,6 +218,7 @@ class Edge:
         for item in other:
             edge = Edge(
                 self.label,
+                self.number,
                 color=self.color,
                 style=self.style,
                 forward=forward or self.forward,
@@ -207,6 +229,8 @@ class Edge:
                 edge.label = item.label or edge.label
                 edge.color = item.color or edge.color
                 edge.style = item.style or edge.style
+                if item.number is not None:
+                    edge.number = item.number
             result.append(edge)
         return result
 
@@ -222,6 +246,8 @@ class Edge:
                 self.color = other.color
             if other.style:
                 self.style = other.style
+            if other.number is not None:
+                self.number = other.number
             return self
         if self.node is not None:
             return self.node.connect(other, self)
@@ -232,27 +258,27 @@ class Edge:
 class Https(Edge):
     """HTTPS connector in Azure blue."""
 
-    def __init__(self, label: str = "HTTPS", **kwargs) -> None:
+    def __init__(self, label: str = "HTTPS", number: int | None = None, **kwargs) -> None:
         kwargs.setdefault("color", "#0078D4")
-        super().__init__(label, **kwargs)
+        super().__init__(label, number, **kwargs)
 
 
 class Async(Edge):
     """Dashed connector for queues, events, and other asynchronous calls."""
 
-    def __init__(self, label: str = "", **kwargs) -> None:
+    def __init__(self, label: str = "", number: int | None = None, **kwargs) -> None:
         kwargs.setdefault("color", "#7C3AED")
         kwargs.setdefault("style", "dashed")
-        super().__init__(label, **kwargs)
+        super().__init__(label, number, **kwargs)
 
 
 class Private(Edge):
     """Dashed green connector for Private Link and private endpoints."""
 
-    def __init__(self, label: str = "", **kwargs) -> None:
+    def __init__(self, label: str = "", number: int | None = None, **kwargs) -> None:
         kwargs.setdefault("color", "#107C41")
         kwargs.setdefault("style", "dashed")
-        super().__init__(label, **kwargs)
+        super().__init__(label, number, **kwargs)
 
 
 class Node(Endpoint):
@@ -267,6 +293,11 @@ class Node(Endpoint):
         *,
         caption: str | bool | None = None,
         icon: str | None = None,
+        sku: str | None = None,
+        region: str | None = None,
+        public: bool | None = None,
+        note: str | None = None,
+        href: str | None = None,
     ) -> None:
         super().__init__()
         parent = _current_parent()
@@ -283,11 +314,18 @@ class Node(Endpoint):
             self.label = service
             self.caption = ""
         self.icon = icon if icon is not None else self.__class__.icon
+        self.sku = _text(sku, "sku")
+        self.region = _text(region, "region")
+        self.public = _check_public(public)
+        self.note = _text(note, "note")
+        self.href = _check_href(href)
         self.diagram = parent.diagram if not isinstance(parent, Diagram) else parent
         self.parent = parent
         parent.children.append(self)
         self.label_lines: list[str] = []
         self.caption_lines: list[str] = []
+        self.detail_lines: list[str] = []
+        self.note_lines: list[str] = []
         self.icon_box = (0.0, 0.0, 0.0, 0.0)
 
     def __init_subclass__(cls, **kwargs) -> None:
@@ -311,9 +349,17 @@ class Group(Endpoint):
         arrange: str | None = None,
         columns: int | None = None,
         align: str | None = None,
+        sku: str | None = None,
+        region: str | None = None,
+        public: bool | None = None,
+        note: str | None = None,
     ) -> None:
         super().__init__()
         self.label = label
+        self.sku = _text(sku, "sku")
+        self.region = _text(region, "region")
+        self.public = _check_public(public)
+        self.note = _text(note, "note")
         self.kind = kind or self.__class__.kind
         self.direction = _check_direction(direction) if direction else None
         self.arrange = arrange
@@ -420,6 +466,38 @@ def _check_direction(direction: str) -> str:
     return value
 
 
+def _text(value: str | None, name: str) -> str:
+    if value is None:
+        return ""
+    if not isinstance(value, str):
+        raise DiagramError(f"{name} must be text")
+    return value.strip()
+
+
+def _check_public(value: bool | None) -> bool | None:
+    if value is None:
+        return None
+    if not isinstance(value, bool):
+        raise DiagramError("public must be true or false")
+    return value
+
+
+def _check_href(value: str | None) -> str:
+    if value is None or value == "":
+        return ""
+    if not isinstance(value, str) or not re.match(r"https?://\S+$", value.strip(), re.IGNORECASE):
+        raise DiagramError("href must be an http or https URL")
+    return value.strip()
+
+
+def _check_number(value: int | None) -> int | None:
+    if value is None:
+        return None
+    if isinstance(value, bool) or not isinstance(value, int) or value < 1:
+        raise DiagramError("Edge number must be a positive integer")
+    return value
+
+
 def _check_color(color: str) -> None:
     if not color:
         return

{infrasketch-2.0.0 → infrasketch-2.1.0}/src/infrasketch/render.py

@@ -35,10 +35,13 @@ def render_svg(diagram: Diagram) -> str:
     note = footnote(diagram)
     width, height = _canvas_size(diagram, note)
     ids = _Ids()
+    link_ns = ""
+    if any(getattr(node, "href", "") for node in _nodes(diagram)):
+        link_ns = ' xmlns:xlink="http://www.w3.org/1999/xlink"'
     parts = [
         '<?xml version="1.0" encoding="UTF-8"?>',
         (
-            f'<svg xmlns="http://www.w3.org/2000/svg" width="{width:.0f}" height="{height:.0f}" '
+            f'<svg xmlns="http://www.w3.org/2000/svg"{link_ns} width="{width:.0f}" height="{height:.0f}" '
             f'viewBox="0 0 {width:.1f} {height:.1f}" role="img" text-rendering="optimizeLegibility">'
         ),
         f"<title>{escape(diagram.title)}</title>",
@@ -66,6 +69,7 @@ def render_svg(diagram: Diagram) -> str:
     for node in _nodes(diagram):
         parts.append(_node(node, ids))
     parts.append(_edge_labels(diagram))
+    parts.append(_legend(diagram))
     parts.append(_title(diagram))
     parts.append(_footer(diagram, width, height, note))
     parts.append("</svg>")
@@ -87,8 +91,14 @@ def _canvas_size(diagram: Diagram, note: str) -> tuple[float, float]:
     note_w = text_width(note, 11) + PAGE_X * 2
     content_right = diagram.origin[0] + diagram.content_w
     content_bottom = diagram.origin[1] + diagram.content_h
-    width = max(content_right + PAGE_X, title_w, sub_w, note_w, 320)
-    height = max(content_bottom + FOOTER + 12, 120)
+    legend = _legend_entries(diagram)
+    legend_w = 0.0
+    legend_h = 0.0
+    if legend:
+        legend_w = max(text_width(f"{number}   {label}", 12) for number, label in legend) + PAGE_X * 2 + 28
+        legend_h = 16.0 + len(legend) * 18.0
+    width = max(content_right + PAGE_X, title_w, sub_w, note_w, legend_w, 320)
+    height = max(content_bottom + legend_h + FOOTER + 12, 120)
     return width, height
 
 
@@ -147,7 +157,10 @@ def _group_header(group: Group, ids: _Ids) -> str:
         icon_y = y + (group.header_h - 20) / 2
         chunks.append(embed_icon(style["icon"], ids.next("g"), x, icon_y, 20))
         text_x = x + 28
-    cursor = y + (14 if header["eyebrow"] else (group.header_h - len(header["title_lines"]) * 16) / 2 + 12)
+    if header.get("detail_lines") or header.get("note_lines"):
+        cursor = y + (14 if header["eyebrow"] else 18)
+    else:
+        cursor = y + (14 if header["eyebrow"] else (group.header_h - len(header["title_lines"]) * 16) / 2 + 12)
     if header["eyebrow"]:
         chunks.append(
             f'<text x="{text_x:.1f}" y="{cursor:.1f}" fill="{style["accent"]}" '
@@ -161,6 +174,18 @@ def _group_header(group: Group, ids: _Ids) -> str:
             f'font-size="13.5" font-weight="600">{escape(line)}</text>'
         )
         cursor += 16
+    for line in header.get("detail_lines", []):
+        chunks.append(
+            f'<text x="{text_x:.1f}" y="{cursor:.1f}" fill="{MUTED}" font-family="{FONT_ATTR}" '
+            f'font-size="11">{escape(line)}</text>'
+        )
+        cursor += 14
+    for line in header.get("note_lines", []):
+        chunks.append(
+            f'<text x="{text_x:.1f}" y="{cursor:.1f}" fill="#475569" font-family="{FONT_ATTR}" '
+            f'font-size="11">{escape(line)}</text>'
+        )
+        cursor += 14
     return "".join(chunks)
 
 
@@ -195,7 +220,26 @@ def _node(node: Node, ids: _Ids) -> str:
                 f'font-family="{FONT_ATTR}" font-size="11">{escape(line)}</text>'
             )
             cursor += 14
-    return "".join(chunks)
+    for line in node.detail_lines:
+        chunks.append(
+            f'<text x="{center:.1f}" y="{cursor:.1f}" text-anchor="middle" fill="{MUTED}" '
+            f'font-family="{FONT_ATTR}" font-size="11">{escape(line)}</text>'
+        )
+        cursor += 14
+    if node.note_lines:
+        cursor += 1
+    for line in node.note_lines:
+        chunks.append(
+            f'<text x="{center:.1f}" y="{cursor:.1f}" text-anchor="middle" fill="#475569" '
+            f'font-family="{FONT_ATTR}" font-size="11">{escape(line)}</text>'
+        )
+        cursor += 14
+    body = "".join(chunks)
+    if not node.href:
+        return body
+    href = escape(node.href, {'"': "&quot;"})
+    tip = escape(node.note or node.label)
+    return f'<a href="{href}" xlink:href="{href}" target="_blank"><title>{tip}</title>{body}</a>'
 
 
 def _edge_path(edge: Connection) -> str:
@@ -219,9 +263,14 @@ def _edge_labels(diagram: Diagram) -> str:
         (group.abs_x, group.abs_y, group.w, min(group.header_h + 4, group.h)) for group in _groups(diagram)
     )
     for edge in diagram.edges:
-        if not edge.label or len(edge.points) < 2:
+        if len(edge.points) < 2 or not (edge.label or edge.number):
             continue
         start, end = _longest(edge.points)
+        if edge.number:
+            labels.append(_number_badge(edge, start, end, occupied))
+            continue
+        if not edge.label:
+            continue
         x = (start[0] + end[0]) / 2
         y = (start[1] + end[1]) / 2
         width = text_width(edge.label, 11) + 14
@@ -242,6 +291,61 @@ def _edge_labels(diagram: Diagram) -> str:
     return "".join(labels)
 
 
+def _number_badge(edge: Connection, start, end, occupied: list) -> str:
+    text = str(edge.number)
+    size = max(16.0, text_width(text, 11) + 8)
+    x = (start[0] + end[0]) / 2
+    y = (start[1] + end[1]) / 2
+    box = (x - size / 2, y - size / 2, size, size)
+    for dx, dy in ((0, 0), (0, 16), (0, -16), (18, 0), (-18, 0)):
+        candidate = (box[0] + dx, box[1] + dy, box[2], box[3])
+        if not any(_overlaps(candidate, other) for other in occupied):
+            box = candidate
+            break
+    occupied.append(box)
+    color = edge.color or EDGE
+    cx = box[0] + box[2] / 2
+    cy = box[1] + box[3] / 2
+    return (
+        f'<circle cx="{cx:.1f}" cy="{cy:.1f}" r="{box[2] / 2:.1f}" fill="#FFFFFF" stroke="{color}" stroke-width="1.4"/>'
+        f'<text x="{cx:.1f}" y="{cy + 4:.1f}" text-anchor="middle" fill="{INK}" '
+        f'font-family="{FONT_ATTR}" font-size="11" font-weight="600">{escape(text)}</text>'
+    )
+
+
+def _legend_entries(diagram: Diagram) -> list[tuple[int, str]]:
+    seen: set[tuple[int, str]] = set()
+    entries = []
+    for edge in diagram.edges:
+        if edge.number is None:
+            continue
+        item = (edge.number, edge.label)
+        if item in seen:
+            continue
+        seen.add(item)
+        entries.append(item)
+    entries.sort(key=lambda item: (item[0], item[1]))
+    return entries
+
+
+def _legend(diagram: Diagram) -> str:
+    entries = _legend_entries(diagram)
+    if not entries:
+        return ""
+    top = diagram.origin[1] + diagram.content_h + 22
+    lines = []
+    for index, (number, label) in enumerate(entries):
+        y = top + index * 18
+        lines.append(
+            f'<circle cx="{PAGE_X + 8:.1f}" cy="{y - 3:.1f}" r="8" fill="#FFFFFF" stroke="{LINE}" stroke-width="1.2"/>'
+            f'<text x="{PAGE_X + 8:.1f}" y="{y:.1f}" text-anchor="middle" fill="{INK}" '
+            f'font-family="{FONT_ATTR}" font-size="11" font-weight="600">{number}</text>'
+            f'<text x="{PAGE_X + 24:.1f}" y="{y:.1f}" fill="{INK}" font-family="{FONT_ATTR}" font-size="12">'
+            f"{escape(label)}</text>"
+        )
+    return "".join(lines)
+
+
 def _title(diagram: Diagram) -> str:
     title = (
         f'<text x="{PAGE_X}" y="40" fill="{INK}" font-family="{FONT_ATTR}" font-size="22" font-weight="600">'

{infrasketch-2.0.0 → infrasketch-2.1.0/src/infrasketch.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: infrasketch
-Version: 2.0.0
+Version: 2.1.0
 Summary: Draw Azure and AWS architecture diagrams as SVG with official resource icons. No Graphviz.
 Author: infrasketch
 License-Expression: MIT AND LicenseRef-Microsoft-Azure-Architecture-Icons AND LicenseRef-AWS-Architecture-Icons
@@ -120,10 +120,26 @@ diagram.save("orders.svg")
 | `a >> Https() >> b` | Azure-blue HTTPS |
 | `a >> Async("enqueue") >> b` | Dashed queue or event |
 | `a >> Private() >> b` | Dashed Private Link |
+| `a >> Https("Open the store", 1) >> b` | Numbered step. The sentence is listed under the drawing |
 
 `style` is `"solid"`, `"dashed"`, or `"dotted"`. `color` is a hex color such
 as `"#0078D4"`.
 
+A resource can carry the design decision and a link. The SKU, region, and
+exposure are a second caption. `note` is the line under that. `href` makes the
+icon a link. The same fields, except `href`, work on a group:
+
+```python
+api = AppService(
+    "Orders API",
+    sku="P1v3",
+    region="West Europe",
+    public=False,
+    note="Private endpoint only",
+    href="https://learn.microsoft.com/azure/app-service/overview",
+)
+```
+
 ## Boundaries
 
 | Group | Use it for |
@@ -192,6 +208,8 @@ to use your own artwork. Azure icons are never recoloured or stretched.
 | `examples/aws_orders.py` | CloudFront, API Gateway, Lambda, DynamoDB, and S3 in a VPC |
 | `examples/aws_eks.py` | EKS, a registry, ElastiCache, and RDS |
 | `examples/aws_events.py` | API Gateway, Lambda, SQS, DynamoDB, and S3 |
+| `examples/azure_decisions.py` | SKU, exposure, notes, numbered steps, and links |
+| `examples/aws_decisions.py` | The same decisions on an AWS drawing |
 
 ![Web, API, and Redis](examples/out/azure-web-api.svg)