From 67c0342444fa569b0de326a71274f9cc05b7f33d Mon Sep 17 00:00:00 2001 From: Travis Kuenzi Date: Thu, 28 May 2026 20:33:51 -0700 Subject: [PATCH 1/3] [docs] codingstyle: Fix SQL indentation image alt text --- general/development/policies/codingstyle/sql.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/general/development/policies/codingstyle/sql.md b/general/development/policies/codingstyle/sql.md index 7a7d9ef30..337f26f4f 100644 --- a/general/development/policies/codingstyle/sql.md +++ b/general/development/policies/codingstyle/sql.md @@ -48,7 +48,9 @@ $records = $DB->get_records_sql($sql, ['above'=>111]); ## Indentation {/* #indentation */} -![sql_indentation.png](./_sql/sql_indentation.png) +![Example of SQL indentation with SELECT, FROM, JOIN, and WHERE clauses aligned vertically for readability.](./_sql/sql_indentation.png) + +Example of SQL indentation with SELECT, FROM, JOIN, and WHERE clauses aligned vertically for readability. ## Subqueries {/* #subqueries */} From d779f12426232f5865544cb4f1abd8248e069905 Mon Sep 17 00:00:00 2001 From: Travis Kuenzi Date: Fri, 5 Jun 2026 08:18:02 -0700 Subject: [PATCH 2/3] [docs] codingstyle: Clarify SQL indentation image description Updates the image markup and visible description in response to maintainer feedback. The SQL indentation image is now treated as a decorative visual example to avoid duplicate screen reader output, while the visible text clarifies that spaces are used to horizontally align the final letter of each SQL keyword into the same vertical column. --- general/development/policies/codingstyle/sql.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/general/development/policies/codingstyle/sql.md b/general/development/policies/codingstyle/sql.md index 337f26f4f..3ba3a1f1f 100644 --- a/general/development/policies/codingstyle/sql.md +++ b/general/development/policies/codingstyle/sql.md @@ -48,9 +48,9 @@ $records = $DB->get_records_sql($sql, ['above'=>111]); ## Indentation {/* #indentation */} -![Example of SQL indentation with SELECT, FROM, JOIN, and WHERE clauses aligned vertically for readability.](./_sql/sql_indentation.png) +![](./_sql/sql_indentation.png) -Example of SQL indentation with SELECT, FROM, JOIN, and WHERE clauses aligned vertically for readability. +This image is a visual example of SQL indentation. It shows spaces used to horizontally align the last letter of the `SELECT`, `FROM`, `JOIN`, and `WHERE` keywords into the same vertical column. ## Subqueries {/* #subqueries */} From f805252723f61bd206419ed20f51c74baec86b15 Mon Sep 17 00:00:00 2001 From: Travis Kuenzi Date: Fri, 5 Jun 2026 08:21:32 -0700 Subject: [PATCH 3/3] [docs] codingstyle: Small lint error fix Remove end of line space. --- general/development/policies/codingstyle/sql.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/general/development/policies/codingstyle/sql.md b/general/development/policies/codingstyle/sql.md index 3ba3a1f1f..ba6b5c1ca 100644 --- a/general/development/policies/codingstyle/sql.md +++ b/general/development/policies/codingstyle/sql.md @@ -48,7 +48,7 @@ $records = $DB->get_records_sql($sql, ['above'=>111]); ## Indentation {/* #indentation */} -![](./_sql/sql_indentation.png) +![](./_sql/sql_indentation.png) This image is a visual example of SQL indentation. It shows spaces used to horizontally align the last letter of the `SELECT`, `FROM`, `JOIN`, and `WHERE` keywords into the same vertical column.