make BS happy - no comments in <pre> blocks, define attestation conve…

…yance

index.bs

@@ -51,6 +51,11 @@ Boilerplate: omit conformance, omit feedback-header, omit abstract-header
 Markup Shorthands: css off, markdown on
 </pre>
 
+<!-- spec: HTML; urlPrefix: https://html.spec.whatwg.org/multipage/ -->
+<!-- L89: Remove these once Shepherd picks up the changes -->
+
+
+
 <pre class="anchors">
 
 spec: ECMAScript; urlPrefix: https://tc39.github.io/ecma262/#
@@ -62,7 +67,7 @@ spec: ECMAScript; urlPrefix: https://tc39.github.io/ecma262/#
             text: internal method
             text: internal slot
 
-<!-- spec: HTML; urlPrefix: https://html.spec.whatwg.org/multipage/ -->
+
 spec: HTML52; urlPrefix: https://w3c.github.io/html/
     type: dfn
         urlPrefix: browsers.html
@@ -81,7 +86,7 @@ spec: WebCryptoAPI; urlPrefix: https://www.w3.org/TR/WebCryptoAPI/
     type: dfn
         text: recognized algorithm name
 
-<!-- Remove these once Shepherd picks up the changes -->
+
 spec: credential-management-1; urlPrefix: https://w3c.github.io/webappsec-credential-management/
     type: dictionary
         text: CredentialCreationOptions; url: dictdef-credentialcreationoptions
@@ -110,6 +115,8 @@ spec: WHATWG HTML; urlPrefix: https://html.spec.whatwg.org/
         text: focus
 </pre> <!-- class=anchors -->
 
+<!-- L128 spec:webappsec-credential-management-1; type:dictionary; for:/; text:CredentialRequestOptions -->
+
 <pre class="link-defaults">
 spec:credential-management; type:dfn; text:credentials
 spec:html; type:dfn; for:environment settings object; text:global object
@@ -118,7 +125,7 @@ spec:infra; type:dfn; for:struct; text:item
 spec:url; type:dfn; text:domain
 spec:url; type:dfn; for:url; text:host
 spec:url; type:dfn; text:valid domain;
-<!-- spec:webappsec-credential-management-1; type:dictionary; for:/; text:CredentialRequestOptions -->
+
 spec:webidl; type:interface; text:Promise
 </pre>
 
@@ -289,7 +296,9 @@ The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "S
     In the WebAuthn context, [=attestation=] is employed to <em>attest</em> to the <em>provenance</em> of an [=authenticator=]
     and the data it emits; including, for example: [=credential IDs=], [=credential key pairs=], signature counters, etc. An
     [=attestation statement=] is conveyed in an [=attestation object=] during [=registration=]. See also [[#sctn-attestation]]
-    and [Figure 3](#fig-attStructs).
+    and [Figure 3](#fig-attStructs). Whether or how the client platform conveys the [=attestation statement=] and [=AAGUID=] 
+    portions of the [=attestation object=] to the [=[RP]=] is described tby <dfn>attestation conveyance</dfn>, see 
+    [[#attestation-convey]].
 
 : <dfn>Attestation Certificate</dfn>
 :: A X.509 Certificate for the <dfn>attestation key pair</dfn> used by an [=authenticator=] to attest to its manufacture
@@ -1556,9 +1565,9 @@ example of the latter, when the user is accessing the [=[RP]=] from a given clie
 use a [=roaming authenticator=] which was originally registered with the [=[RP]=] using a different client.
 
 
-### Attestation Conveyance Preference enumeration (enum <dfn enum>AttestationConveyancePreference</dfn>) ### {#attestation}
+### Attestation Conveyance Preference enumeration (enum <dfn enum>AttestationConveyancePreference</dfn>) ### {#attestation-convey}
 
-[=[RPS]=] may use {{AttestationConveyancePreference}} to specify their preference regarding attestation conveyance
+[=[RPS]=] may use {{AttestationConveyancePreference}} to specify their preference regarding [=attestation conveyance=]
 during credential generation.
 
 <pre class="idl">
@@ -1625,7 +1634,7 @@ an assertion. Its {{PublicKeyCredentialRequestOptions/challenge}} member must be
     ::  This optional member contains a list of {{PublicKeyCredentialDescriptor}} object representing [=public key credentials=]
         acceptable to the caller, in decending order of the caller's preference (the first item in the list is the most
         preferred credential, and so on down the list).
-    
+
     :   <dfn>extensions</dfn>
     ::  This optional member contains additional parameters requesting additional processing by the client and authenticator.
         For example, if transaction confirmation is sought from the user, then the prompt string might be included as an