Updating xml doc comments. Also updating MD docs with permalinks when needed. (#212)

Author: StephenMolloy

docs/FAQ.md

@@ -29,7 +29,7 @@ some of the most frequent along with answers that are hopefully helpful.
 > xml through the use of token expansion that doesn't conform to the convenient mental paradigm of
 > only placing tokens within obvious key/value places of existing well-formed xml... you can try
 > [this wrapper approach](../samples/SamplesLib/ExpandWrapper.cs) as is demonstrated in the
-> [SampleConsoleApp](../samples/SampleConsoleApp/App.config#L36-L39).
+> [SampleConsoleApp](https://github.com/aspnet/MicrosoftConfigurationBuilders/blob/1bdc2388f139c046e1c58bcc147c875d5c918785/samples/SampleConsoleApp/App.config#L50-L53).
 > </sub></sub>
 </details>
 

docs/SectionHandlers.md

@@ -115,7 +115,7 @@ One thing to note is that the mechanism for associating a key/value lookup with
 is a simple post-fix to the key. This makes this feature incompatible with versioned keys in Azure Key Vault. Most other cases should
 just work as they did before, with a little extra magic cleanliness when you start using this feature.
 
-An example of this new behavior from `ConnectionStringsSectionHandler2` can be seen in the [SampleConsoleApp](samples/SampleConsoleApp/App.config#L37-L46).
-Or in the [test project](https://github.com/aspnet/MicrosoftConfigurationBuilders/blob/main/test/Microsoft.Configuration.ConfigurationBuilders.Test/ConnectionStringsSectionHandler2Tests.cs).
-The [SampleWebApp](samples/SampleWebApp/Web.config#L38-L41) does not use the new section handler, but it does include some notes about how
+An example of this new behavior from `ConnectionStringsSectionHandler2` can be seen in the [SampleConsoleApp](https://github.com/aspnet/MicrosoftConfigurationBuilders/blob/1bdc2388f139c046e1c58bcc147c875d5c918785/samples/SampleConsoleApp/App.config#L37-L46).
+Or in the [test project](https://github.com/aspnet/MicrosoftConfigurationBuilders/blob/1bdc2388f139c046e1c58bcc147c875d5c918785/test/Microsoft.Configuration.ConfigurationBuilders.Test/ConnectionStringsSectionHandler2Tests.cs).
+The [SampleWebApp](https://github.com/aspnet/MicrosoftConfigurationBuilders/blob/1bdc2388f139c046e1c58bcc147c875d5c918785/samples/SampleWebApp/Web.config#L38-L41) does not use the new section handler, but it does include some notes about how
 it's resulting connection string collection would look different if it did.

src/Azure/AzureKeyVaultConfigBuilder.cs

@@ -164,9 +164,9 @@ public override string GetValue(string key)
         /// </summary>
         /// <returns>A token credential.</returns>
         protected virtual TokenCredential GetCredential() => new DefaultAzureCredential();
-        
+
         /// <summary>
-        /// Gets a <see cref="SecretClientOptions"/> to initialize the Key Vault SecretClient with. This defaults to <see cref="null"/>.
+        /// Gets a <see cref="SecretClientOptions"/> to initialize the Key Vault SecretClient with. This defaults to a new <see cref="SecretClientOptions"/>.
         /// </summary>
         /// <returns>A token credential.</returns>
         protected virtual SecretClientOptions GetSecretClientOptions() => new SecretClientOptions();

src/AzureAppConfig/AzureAppConfigurationBuilder.cs

@@ -225,9 +225,9 @@ public override ICollection<KeyValuePair<string, string>> GetAllValues(string pr
         /// </summary>
         /// <returns>A token credential.</returns>
         protected virtual TokenCredential GetCredential() => new DefaultAzureCredential();
-        
+
         /// <summary>
-        /// Gets a <see cref="ConfigurationClientOptions"/> to initialize the Key Vault SecretClient with. This defaults to <see cref="null"/>.
+        /// Gets a <see cref="ConfigurationClientOptions"/> to initialize the Key Vault SecretClient with. This defaults to a new <see cref="ConfigurationClientOptions"/>.
         /// </summary>
         /// <returns>A token credential.</returns>
         protected virtual ConfigurationClientOptions GetConfigurationClientOptions() => new ConfigurationClientOptions();