diff --git a/Sources/Edge.swift b/Sources/Edge.swift
index 180df9f8..caad47c4 100644
--- a/Sources/Edge.swift
+++ b/Sources/Edge.swift
@@ -31,9 +31,9 @@
 
 /// A polygon edge.
 public struct Edge: Hashable, Sendable {
-    // The starting point of the line segment.
+    /// The starting point of the line segment.
     public let start: Vertex
-    // The end point of the line segment.
+    /// The end point of the line segment.
     public let end: Vertex
 
     /// Creates an edge with a start and end vertex.
diff --git a/Tests/PolygonTests.swift b/Tests/PolygonTests.swift
index a4ec57ca..512a537b 100644
--- a/Tests/PolygonTests.swift
+++ b/Tests/PolygonTests.swift
@@ -10,7 +10,7 @@
 import XCTest
 
 extension Euclid.Polygon: ExpressibleByArrayLiteral {
-    // Convenience constructor for testing
+    /// Convenience constructor for testing
     init(unchecked vertices: [Vertex], plane: Plane? = nil) {
         self.init(
             unchecked: vertices,