From a0e9594f509838acf9b434d6ed8d29e0c78150aa Mon Sep 17 00:00:00 2001
From: Johan Fagerberg <jofa@tv2.dk>
Date: Thu, 19 Feb 2026 11:01:28 +0100
Subject: [PATCH] chore: clean up over-explanations slightly

---
 README.md         | 18 +++++++++---------
 renderer/image.go | 15 +++++----------
 2 files changed, 14 insertions(+), 19 deletions(-)

diff --git a/README.md b/README.md
index f4e2ac6..d27c009 100644
--- a/README.md
+++ b/README.md
@@ -85,7 +85,7 @@ You can set the alignment for all images in the page. Common values are `left`,
 
 **Note**: Images with width >= 760px automatically use `ac:align="wide"` with `ac:layout="center"` instead of the configured alignment, as Confluence requires this for wide images.
 
-Custom values are passed through as-is with only the `ac:align` attribute. Can also be set globally via the `--image-align` CLI option (per-page header takes precedence).
+Can also be set globally via the `--image-align` CLI option (per-page header takes precedence).
 
 Mark supports Go templates, which can be included into article by using path
 to the template relative to current working dir, e.g.:
@@ -266,23 +266,23 @@ some long bash code block
 | `linenumbers`                  | false   |
 | `1` (any number for firstline) | 1       |
 
-Example:  
+Example:
 
-* `bash collapse`  
+* `bash collapse`
   If you have long code blocks, you can make them collapsible.
-* `bash collapse title Some long long bash function`  
+* `bash collapse title Some long long bash function`
   And you can also add a title.
-* `bash linenumbers collapse title Some long long bash function`  
+* `bash linenumbers collapse title Some long long bash function`
   And linenumbers.
-* `bash 1 collapse title Some long long bash function`  
+* `bash 1 collapse title Some long long bash function`
   Or directly give a number as firstline number.
-* `bash 1 collapse midnight title Some long long bash function`  
+* `bash 1 collapse midnight title Some long long bash function`
   And even themes.
-* `- 1 collapse midnight title Some long long code`  
+* `- 1 collapse midnight title Some long long code`
   Please note that, if you want to have a code block without a language
   use `-` as the first character, if you want to have the other goodies.
 
-More details at Confluence [Code Block Macro](https://confluence.atlassian.com/doc/code-block-macro-139390.html) doc.  
+More details at Confluence [Code Block Macro](https://confluence.atlassian.com/doc/code-block-macro-139390.html) doc.
 
 ### Block Quotes
 
diff --git a/renderer/image.go b/renderer/image.go
index 442ce51..b36a652 100644
--- a/renderer/image.go
+++ b/renderer/image.go
@@ -19,33 +19,29 @@ import (
 // calculateAlign determines the appropriate ac:align value
 // Images >= 760px must use "center" alignment, smaller images can use configured alignment
 func calculateAlign(configuredAlign string, width string) string {
-	// No alignment configured
 	if configuredAlign == "" {
 		return ""
 	}
-	
-	// Check if image is wide enough to require center alignment
+
 	if width != "" {
 		widthInt, err := strconv.Atoi(width)
 		if err == nil && widthInt >= 760 {
 			return "center"
 		}
 	}
-	
-	// For images < 760px, use configured alignment
+
 	return configuredAlign
 }
 
 // calculateLayout determines the appropriate ac:layout value based on width and alignment
 // Images >= 1800px use "full-width", images >= 760px use "wide", otherwise based on alignment
+// These thresholds are based on Confluence's behavior as of 2026-02, but may need adjustment in the future
 // Returns empty string if no alignment is configured
 func calculateLayout(align string, width string) string {
-	// If no alignment configured, don't set layout
 	if align == "" {
 		return ""
 	}
-	
-	// Check width thresholds first
+
 	if width != "" {
 		widthInt, err := strconv.Atoi(width)
 		if err == nil {
@@ -57,8 +53,7 @@ func calculateLayout(align string, width string) string {
 			}
 		}
 	}
-	
-	// For images < 760px, use layout based on alignment
+
 	switch align {
 	case "left":
 		return "align-start"