From 4b734e0d5c94a08392fa742f4725b0aaa734ea44 Mon Sep 17 00:00:00 2001 From: Dennis Doomen Date: Wed, 25 Mar 2026 07:12:17 -0700 Subject: [PATCH 1/3] Update AV1755 guideline Split from #298. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- _rules/1755.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_rules/1755.md b/_rules/1755.md index af721d61..edc9410c 100644 --- a/_rules/1755.md +++ b/_rules/1755.md @@ -1,7 +1,7 @@ --- rule_id: 1755 rule_category: naming-conventions -title: Postfix asynchronous methods with `Async` or `TaskAsync` +title: Only use `Async` or `TaskAsync` as a suffix when a method has both synchronous and asynchronous versions severity: 2 --- -The general convention for methods and local functions that return `Task` or `Task` is to postfix them with `Async`. But if such a method already exists, use `TaskAsync` instead. +Only postfix a method or local function that returns `Task` or `Task` with `Async` if there is also a synchronous version of that method. If the only version is asynchronous, the `Async` suffix adds unnecessary noise. If both synchronous and asynchronous versions exist, use `Async` as the postfix. If a method named `Async` already exists, use `TaskAsync` instead. From 6dcc5abb19cc358bd463a5c5e5588d7199876cba Mon Sep 17 00:00:00 2001 From: Dennis Doomen Date: Tue, 14 Apr 2026 07:11:22 +0200 Subject: [PATCH 2/3] Update _rules/1755.md Co-authored-by: Bart Koelman <10324372+bkoelman@users.noreply.github.com> --- _rules/1755.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_rules/1755.md b/_rules/1755.md index edc9410c..f6566d36 100644 --- a/_rules/1755.md +++ b/_rules/1755.md @@ -4,4 +4,4 @@ rule_category: naming-conventions title: Only use `Async` or `TaskAsync` as a suffix when a method has both synchronous and asynchronous versions severity: 2 --- -Only postfix a method or local function that returns `Task` or `Task` with `Async` if there is also a synchronous version of that method. If the only version is asynchronous, the `Async` suffix adds unnecessary noise. If both synchronous and asynchronous versions exist, use `Async` as the postfix. If a method named `Async` already exists, use `TaskAsync` instead. +Only suffix a method or local function that returns `Task` or `Task` with `Async` if there is also a synchronous version of that method. If the only version is asynchronous, the `Async` suffix adds unnecessary noise. If both synchronous and asynchronous versions exist, use `Async` as the postfix. If a method named `Async` already exists, use `TaskAsync` instead. From 58fe20cb55fbaa3f99f41a45ff218ff14fcb2741 Mon Sep 17 00:00:00 2001 From: Dennis Doomen Date: Wed, 15 Apr 2026 08:28:42 +0200 Subject: [PATCH 3/3] Update _rules/1755.md Co-authored-by: Bart Koelman <10324372+bkoelman@users.noreply.github.com> --- _rules/1755.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_rules/1755.md b/_rules/1755.md index f6566d36..74a326aa 100644 --- a/_rules/1755.md +++ b/_rules/1755.md @@ -4,4 +4,4 @@ rule_category: naming-conventions title: Only use `Async` or `TaskAsync` as a suffix when a method has both synchronous and asynchronous versions severity: 2 --- -Only suffix a method or local function that returns `Task` or `Task` with `Async` if there is also a synchronous version of that method. If the only version is asynchronous, the `Async` suffix adds unnecessary noise. If both synchronous and asynchronous versions exist, use `Async` as the postfix. If a method named `Async` already exists, use `TaskAsync` instead. +Only suffix a method or local function that returns `Task` or `Task` with `Async` if there is also a synchronous variant of that method. If no synchronous variant exists, the `Async` suffix adds unnecessary noise. If both synchronous and asynchronous variants exist, use `Async` as the suffix. If a method suffixed with `Async` already exists, use `TaskAsync` instead.