Updated C28285

Updated to the new format

Author: MugBergerFries

docs/code-quality/c28285.md

@@ -1,35 +1,37 @@
 ---
 description: "Learn more about: C28285"
 title: C28285
-ms.date: 12/17/2019
+ms.date: 09/22/2022
 ms.topic: reference
-f1_keywords: ["C28285"]
+f1_keywords: ["C28285", "SPEC_INVALID_SYNTAX2", "__WARNING_SPEC_INVALID_SYNTAX2"]
 helpviewer_keywords: ["C28285"]
 ms.assetid: 6197eb0f-7e1e-4c3e-b097-1f6481405994
 ---
-# C28285
+# Warning C28285
 
-> warning C28285: For function 'function_name', syntax error in 'annotation'
+> For function '*function-name*', syntax error in '*annotation*'
 
-The Code Analysis tool reports this warning for syntax errors in the SAL annotation.  The SAL parser will recover by discarding the malformed annotation.
+## Remarks
+
+The Code Analysis tool reports this warning for syntax errors in the SAL annotation. The SAL parser will recover by discarding the malformed annotation. Double check the documentation for the SAL annotations being used and try to simplify the annotation. You should not use implementation layer annotations such as `__declspec("SAL_begin")` directly. If you are using that layer then change them into higher layers such as `_In_`/`_Out_`/`_Ret_`.  See [Annotating Function Parameters and Return Values](annotating-function-parameters-and-return-values.md) for more information.
 
 ## Example
 
+The following code generates this warning. The argument `(2,n)` is malformed and will cause a C28285 warning after the _Out_writes_z_ macro is expanded.
+
 ```cpp
-// The argument '(n,2)' is malformed and will cause a C28285 warning after the _Out_writes_z_ macro is expanded.
 void example_func(_Out_writes_z_((2,n)) char* buffer, int n)
 {
-  // ...
-  buffer[n] = '\0';
+    buffer[n] = '\0';
 }
 ```
 
-Double check the documentation to the SAL annotations being used and try to simplify the annotation.  You should not use implementation layer annotations such as `__declspec("SAL_begin")` directly. If you are using that layer then change them into higher layers such as `_In_`/`_Out_`/`_Ret_`.  See [Annotating Function Parameters and Return Values](annotating-function-parameters-and-return-values.md) for more information.
+The following code remediates this warning by correcting the malformed annotation
 
 ```cpp
 void example_func(_Out_writes_z_(n) char* buffer, int n)
 {
-  // ...
-  buffer[n] = '\0';
+    buffer[n] = '\0';
 }
 ```
+