Formatting markdown files

CONTRIBUTING.md

@@ -84,7 +84,8 @@ We use and recommend the following workflow:
 5. Make and commit your changes to your branch.
     - [Code Flow and PRs](./contributordocs/code-flow-and-pull-requests.md#getting-your-code-ready-for-review)
       explains how to build and test.
-    - Your commits must be [signed](https://docs.github.com/en/github/authenticating-to-github/managing-commit-signature-verification/signing-commits).
+    - Your commits must
+      be [signed](https://docs.github.com/en/github/authenticating-to-github/managing-commit-signature-verification/signing-commits).
     - Please follow our [Commit Messages](#commit-messages) guidance.
 6. [Build the repository](./contributordocs/code-flow-and-pull-requests.md#getting-your-code-ready-for-review)
    with your changes.
@@ -94,14 +95,16 @@ We use and recommend the following workflow:
     - State in the description what issue or improvement suggestion your change is addressing.
     - Check if all the Continuous Integration checks are passing.
 8. Wait for feedback or approval of your changes from the necessary project maintainers.
-    - Details about the [pull request procedure here](./contributordocs/code-flow-and-pull-requests.md#merging-into-develop).
+    - Details about
+      the [pull request procedure here](./contributordocs/code-flow-and-pull-requests.md#merging-into-develop).
 9. When the necessary project maintainers have signed off, and all checks are green, your PR will be merged.
     - The schedule of official releases will be determined by project maintainers.
     - You can delete the branch you used for making the change.
 
 ## Commit Messages
 
-Please format commit messages as follows (based on [Go Contribution Guide](https://golang.org/doc/contribute#commit_messages)):
+Please format commit messages as follows (based
+on [Go Contribution Guide](https://golang.org/doc/contribute#commit_messages)):
 
 ```
 The first line is a short one-line summary of the change
@@ -127,7 +130,8 @@ commit, and not too small with the same small change applied N times in N differ
 ## Contributions Licensing
 
 Contributions to this repository are subject to the GitHub Terms of Service. The licensing of
-contributions is covered by section [D.6 "Contributions Under Repository License"](https://docs.github.com/en/github/site-policy/github-terms-of-service#6-contributions-under-repository-license):
+contributions is covered by
+section [D.6 "Contributions Under Repository License"](https://docs.github.com/en/github/site-policy/github-terms-of-service#6-contributions-under-repository-license):
 
 > Whenever you add Content to a repository containing notice of a license, you license that Content
 > under the same terms, and you agree that you have the right to license that Content under those
@@ -197,11 +201,11 @@ these works:
 The following rules must be followed for PRs that include files from another project:
 
 - The license of the file is compatible with Apache License 2.0, such as
-  - Apache License 2.0
-  - Apache Software License 1.1
-  - BSD (without advertising clause)
-  - MIT/X11
-  - [Full list here](https://www.apache.org/legal/resolved.html#category-a)
+    - Apache License 2.0
+    - Apache Software License 1.1
+    - BSD (without advertising clause)
+    - MIT/X11
+    - [Full list here](https://www.apache.org/legal/resolved.html#category-a)
 - The license of the file is left in-tact.
 - The contribution is correctly attributed, as needed (generally in LICENSE.txt or NOTICE.txt in
   project root).

README.md

@@ -12,22 +12,23 @@ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License. -->
 
-> ![build-action-status](https://github.com/Yubico/Yubico.NET.SDK/actions/workflows/build.yml/badge.svg) 
-> ![tests-action-status](https://github.com/Yubico/Yubico.NET.SDK/actions/workflows/test.yml/badge.svg) 
-> ![tests-windows-action-status](https://github.com/Yubico/Yubico.NET.SDK/actions/workflows/test-windows.yml/badge.svg) 
-> ![tests-ubuntu-action-status](https://github.com/Yubico/Yubico.NET.SDK/actions/workflows/test-ubuntu.yml/badge.svg) 
-> ![tests-macos-action-status](https://github.com/Yubico/Yubico.NET.SDK/actions/workflows/test-macos.yml/badge.svg) 
-> ![codeql-analysis-action-status](https://github.com/Yubico/Yubico.NET.SDK/actions/workflows/codeql-analysis.yml/badge.svg)  
+> ![build-action-status](https://github.com/Yubico/Yubico.NET.SDK/actions/workflows/build.yml/badge.svg)
+> ![tests-action-status](https://github.com/Yubico/Yubico.NET.SDK/actions/workflows/test.yml/badge.svg)
+> ![tests-windows-action-status](https://github.com/Yubico/Yubico.NET.SDK/actions/workflows/test-windows.yml/badge.svg)
+> ![tests-ubuntu-action-status](https://github.com/Yubico/Yubico.NET.SDK/actions/workflows/test-ubuntu.yml/badge.svg)
+> ![tests-macos-action-status](https://github.com/Yubico/Yubico.NET.SDK/actions/workflows/test-macos.yml/badge.svg)
+> ![codeql-analysis-action-status](https://github.com/Yubico/Yubico.NET.SDK/actions/workflows/codeql-analysis.yml/badge.svg)
 
 # .NET YubiKey SDK
 
 This is a cross-platform, all encompassing SDK for the YubiKey aimed at large to mid-sized enterprise
 customers. This version is written against .NET Core, and will eventually include bindings to languages
-outside of the direct .NET ecosystem.
+outside the direct .NET ecosystem.
 
 ## Documentation
 
-The public documentation for this project is located at [https://docs.yubico.com/yesdk/](https://docs.yubico.com/yesdk/).
+The public documentation for this project is located
+at [https://docs.yubico.com/yesdk/](https://docs.yubico.com/yesdk/).
 Here you can find both API reference and a user's manual that describes the concepts that this SDK exposes.
 
 ## Project structure

Yubico.NET.SDK.sln

@@ -121,42 +121,43 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Otp", "Otp", "{BA01E787-FF0
 		Yubico.YubiKey\docs\users-manual\application-otp\slots.md = Yubico.YubiKey\docs\users-manual\application-otp\slots.md
 		Yubico.YubiKey\docs\users-manual\application-otp\static-password.md = Yubico.YubiKey\docs\users-manual\application-otp\static-password.md
 		Yubico.YubiKey\docs\users-manual\application-otp\yubico-otp.md = Yubico.YubiKey\docs\users-manual\application-otp\yubico-otp.md
+		Yubico.YubiKey\docs\users-manual\application-otp\challenge-response.md = Yubico.YubiKey\docs\users-manual\application-otp\challenge-response.md
+		Yubico.YubiKey\docs\users-manual\application-otp\commands-challenge-response.md = Yubico.YubiKey\docs\users-manual\application-otp\commands-challenge-response.md
+		Yubico.YubiKey\docs\users-manual\application-otp\commands-configure-slot.md = Yubico.YubiKey\docs\users-manual\application-otp\commands-configure-slot.md
+		Yubico.YubiKey\docs\users-manual\application-otp\commands-get-device-info.md = Yubico.YubiKey\docs\users-manual\application-otp\commands-get-device-info.md
+		Yubico.YubiKey\docs\users-manual\application-otp\commands-get-serial.md = Yubico.YubiKey\docs\users-manual\application-otp\commands-get-serial.md
+		Yubico.YubiKey\docs\users-manual\application-otp\commands-program-ndef.md = Yubico.YubiKey\docs\users-manual\application-otp\commands-program-ndef.md
+		Yubico.YubiKey\docs\users-manual\application-otp\commands-query-fips-mode.md = Yubico.YubiKey\docs\users-manual\application-otp\commands-query-fips-mode.md
+		Yubico.YubiKey\docs\users-manual\application-otp\commands-read-ndef.md = Yubico.YubiKey\docs\users-manual\application-otp\commands-read-ndef.md
+		Yubico.YubiKey\docs\users-manual\application-otp\commands-read-status.md = Yubico.YubiKey\docs\users-manual\application-otp\commands-read-status.md
+		Yubico.YubiKey\docs\users-manual\application-otp\commands-swap-slots.md = Yubico.YubiKey\docs\users-manual\application-otp\commands-swap-slots.md
+		Yubico.YubiKey\docs\users-manual\application-otp\commands-update-scan-code-map.md = Yubico.YubiKey\docs\users-manual\application-otp\commands-update-scan-code-map.md
+		Yubico.YubiKey\docs\users-manual\application-otp\commands-update-slot.md = Yubico.YubiKey\docs\users-manual\application-otp\commands-update-slot.md
+		Yubico.YubiKey\docs\users-manual\application-otp\how-to-program-an-hotp-credential.md = Yubico.YubiKey\docs\users-manual\application-otp\how-to-program-an-hotp-credential.md
+		Yubico.YubiKey\docs\users-manual\application-otp\how-to-slot-access-codes.md = Yubico.YubiKey\docs\users-manual\application-otp\how-to-slot-access-codes.md
+		Yubico.YubiKey\docs\users-manual\application-otp\how-tos-overview.md = Yubico.YubiKey\docs\users-manual\application-otp\how-tos-overview.md
 	EndProjectSection
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Piv", "Piv", "{DBCBCAC7-DDB0-4062-A6FF-4386702F9D4F}"
 	ProjectSection(SolutionItems) = preProject
 		Yubico.YubiKey\docs\users-manual\application-piv\access-control.md = Yubico.YubiKey\docs\users-manual\application-piv\access-control.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\attest.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\attest.md
 		Yubico.YubiKey\docs\users-manual\application-piv\attestation.md = Yubico.YubiKey\docs\users-manual\application-piv\attestation.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\auth-decrypt.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\auth-decrypt.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\auth-key-agree.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\auth-key-agree.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\auth-mgmt.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\auth-mgmt.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\auth-sign.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\auth-sign.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\change-ref.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\change-ref.md
+		Yubico.YubiKey\docs\users-manual\application-piv\cert-request.md = Yubico.YubiKey\docs\users-manual\application-piv\cert-request.md
+		Yubico.YubiKey\docs\users-manual\application-piv\cert-size.md = Yubico.YubiKey\docs\users-manual\application-piv\cert-size.md
 		Yubico.YubiKey\docs\users-manual\application-piv\commands.md = Yubico.YubiKey\docs\users-manual\application-piv\commands.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\generate-pair.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\generate-pair.md
+		Yubico.YubiKey\docs\users-manual\application-piv\ecdsa-signatures.md = Yubico.YubiKey\docs\users-manual\application-piv\ecdsa-signatures.md
 		Yubico.YubiKey\docs\users-manual\application-piv\get-and-put-data.md = Yubico.YubiKey\docs\users-manual\application-piv\get-and-put-data.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\get-data.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\get-data.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\import-asym.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\import-asym.md
 		Yubico.YubiKey\docs\users-manual\application-piv\keeping-track.md = Yubico.YubiKey\docs\users-manual\application-piv\keeping-track.md
 		Yubico.YubiKey\docs\users-manual\application-piv\key-agreement.md = Yubico.YubiKey\docs\users-manual\application-piv\key-agreement.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\metadata.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\metadata.md
 		Yubico.YubiKey\docs\users-manual\application-piv\migrate-smartcardnet.md = Yubico.YubiKey\docs\users-manual\application-piv\migrate-smartcardnet.md
+		Yubico.YubiKey\docs\users-manual\application-piv\pin-only.md = Yubico.YubiKey\docs\users-manual\application-piv\pin-only.md
 		Yubico.YubiKey\docs\users-manual\application-piv\pin-puk-mgmt-key.md = Yubico.YubiKey\docs\users-manual\application-piv\pin-puk-mgmt-key.md
 		Yubico.YubiKey\docs\users-manual\application-piv\pin-touch-policies.md = Yubico.YubiKey\docs\users-manual\application-piv\pin-touch-policies.md
+		Yubico.YubiKey\docs\users-manual\application-piv\piv-objects.md = Yubico.YubiKey\docs\users-manual\application-piv\piv-objects.md
 		Yubico.YubiKey\docs\users-manual\application-piv\piv-overview.md = Yubico.YubiKey\docs\users-manual\application-piv\piv-overview.md
 		Yubico.YubiKey\docs\users-manual\application-piv\private-keys.md = Yubico.YubiKey\docs\users-manual\application-piv\private-keys.md
 		Yubico.YubiKey\docs\users-manual\application-piv\public-keys.md = Yubico.YubiKey\docs\users-manual\application-piv\public-keys.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\put-data.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\put-data.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\put-vendor-data.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\put-vendor-data.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\reset-piv.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\reset-piv.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\reset-retry.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\reset-retry.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\serial.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\serial.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\set-mgmt-key.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\set-mgmt-key.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\set-pin-retries.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\set-pin-retries.md
 		Yubico.YubiKey\docs\users-manual\application-piv\slots.md = Yubico.YubiKey\docs\users-manual\application-piv\slots.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\verify.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\verify.md
-		Yubico.YubiKey\docs\users-manual\application-piv\apdu\version.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\version.md
 	EndProjectSection
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Getting Started", "Getting Started", "{D8091437-C063-4CC2-A52A-5734AE23FB0F}"
@@ -180,6 +181,8 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Sdk Programming Guide", "Sd
 		Yubico.YubiKey\docs\users-manual\sdk-programming-guide\sensitive-data.md = Yubico.YubiKey\docs\users-manual\sdk-programming-guide\sensitive-data.md
 		Yubico.YubiKey\docs\users-manual\sdk-programming-guide\threads.md = Yubico.YubiKey\docs\users-manual\sdk-programming-guide\threads.md
 		Yubico.YubiKey\docs\users-manual\sdk-programming-guide\appcompat.md = Yubico.YubiKey\docs\users-manual\sdk-programming-guide\appcompat.md
+		Yubico.YubiKey\docs\users-manual\sdk-programming-guide\key-collector-touch.md = Yubico.YubiKey\docs\users-manual\sdk-programming-guide\key-collector-touch.md
+		Yubico.YubiKey\docs\users-manual\sdk-programming-guide\pin-complexity-policy.md = Yubico.YubiKey\docs\users-manual\sdk-programming-guide\pin-complexity-policy.md
 	EndProjectSection
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Apdu", "Apdu", "{BA394A0D-B336-4B6E-83B8-B41FC165D6D9}"
@@ -189,6 +192,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Apdu", "Apdu", "{BA394A0D-B
 		Yubico.YubiKey\docs\users-manual\application-piv\apdu\auth-key-agree.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\auth-key-agree.md
 		Yubico.YubiKey\docs\users-manual\application-piv\apdu\auth-mgmt.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\auth-mgmt.md
 		Yubico.YubiKey\docs\users-manual\application-piv\apdu\auth-sign.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\auth-sign.md
+		Yubico.YubiKey\docs\users-manual\application-piv\apdu\bio-metadata.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\bio-metadata.md
 		Yubico.YubiKey\docs\users-manual\application-piv\apdu\change-ref.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\change-ref.md
 		Yubico.YubiKey\docs\users-manual\application-piv\apdu\generate-pair.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\generate-pair.md
 		Yubico.YubiKey\docs\users-manual\application-piv\apdu\get-data.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\get-data.md
@@ -201,6 +205,8 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Apdu", "Apdu", "{BA394A0D-B
 		Yubico.YubiKey\docs\users-manual\application-piv\apdu\serial.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\serial.md
 		Yubico.YubiKey\docs\users-manual\application-piv\apdu\set-mgmt-key.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\set-mgmt-key.md
 		Yubico.YubiKey\docs\users-manual\application-piv\apdu\set-pin-retries.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\set-pin-retries.md
+		Yubico.YubiKey\docs\users-manual\application-piv\apdu\verify-temporary-pin.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\verify-temporary-pin.md
+		Yubico.YubiKey\docs\users-manual\application-piv\apdu\verify-uv.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\verify-uv.md
 		Yubico.YubiKey\docs\users-manual\application-piv\apdu\verify.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\verify.md
 		Yubico.YubiKey\docs\users-manual\application-piv\apdu\version.md = Yubico.YubiKey\docs\users-manual\application-piv\apdu\version.md
 	EndProjectSection
@@ -218,7 +224,6 @@ EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "YubiKey Reference", "YubiKey Reference", "{E7B994D1-AB44-4799-B98B-00515A9C63CE}"
 	ProjectSection(SolutionItems) = preProject
 		Yubico.YubiKey\docs\users-manual\yubikey-reference\apdu.md = Yubico.YubiKey\docs\users-manual\yubikey-reference\apdu.md
-		Yubico.YubiKey\docs\users-manual\yubikey-reference\hardware.md = Yubico.YubiKey\docs\users-manual\yubikey-reference\hardware.md
 	EndProjectSection
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Transports", "Transports", "{FEE624EE-2E54-4E02-9492-C646D6FB3C68}"
@@ -288,6 +293,14 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Fido2", "Fido2", "{8CE9438B
 		Yubico.YubiKey\docs\users-manual\application-fido2\how-fido2-works.md = Yubico.YubiKey\docs\users-manual\application-fido2\how-fido2-works.md
 		Yubico.YubiKey\docs\users-manual\application-fido2\large-blobs.md = Yubico.YubiKey\docs\users-manual\application-fido2\large-blobs.md
 		Yubico.YubiKey\docs\users-manual\application-fido2\pin-uv-auth-protocols.md = Yubico.YubiKey\docs\users-manual\application-fido2\pin-uv-auth-protocols.md
+		Yubico.YubiKey\docs\users-manual\application-fido2\fido2-auth-tokens.md = Yubico.YubiKey\docs\users-manual\application-fido2\fido2-auth-tokens.md
+		Yubico.YubiKey\docs\users-manual\application-fido2\fido2-auth.md = Yubico.YubiKey\docs\users-manual\application-fido2\fido2-auth.md
+		Yubico.YubiKey\docs\users-manual\application-fido2\fido2-authenticator-config.md = Yubico.YubiKey\docs\users-manual\application-fido2\fido2-authenticator-config.md
+		Yubico.YubiKey\docs\users-manual\application-fido2\fido2-bio-enrollment.md = Yubico.YubiKey\docs\users-manual\application-fido2\fido2-bio-enrollment.md
+		Yubico.YubiKey\docs\users-manual\application-fido2\fido2-min-pin-len.md = Yubico.YubiKey\docs\users-manual\application-fido2\fido2-min-pin-len.md
+		Yubico.YubiKey\docs\users-manual\application-fido2\fido2-touch-notification.md = Yubico.YubiKey\docs\users-manual\application-fido2\fido2-touch-notification.md
+		Yubico.YubiKey\docs\users-manual\application-fido2\hmac-secret.md = Yubico.YubiKey\docs\users-manual\application-fido2\hmac-secret.md
+		Yubico.YubiKey\docs\users-manual\application-fido2\sdk-auth-token-logic.md = Yubico.YubiKey\docs\users-manual\application-fido2\sdk-auth-token-logic.md
 	EndProjectSection
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "YubiHSM Auth", "YubiHSM Auth", "{4176F4C2-3A9E-4C89-96B6-48CF41DD98C2}"

Yubico.YubiKey/docs/filterConfig.yml

@@ -13,6 +13,6 @@
 # limitations under the License.
 
 apiRules:
-- exclude:
+  - exclude:
       uidRegex: ^System\.*
       type: Type