PBJS: documentation for yield and legacyRender flags

dev-docs/publisher-api-reference/setConfig.md

@@ -1290,6 +1290,7 @@ The `auctionOptions` object controls aspects related to auctions.
 | `secondaryBidders` | Optional | Array of Strings | Specifies bidders that the Prebid auction will no longer wait for before determining the auction has completed. This may be helpful if you find there are a number of low performing and/or high timeout bidders in your page's rotation. |
 | `suppressStaleRender` | Optional | Boolean | When true, prevents `banner` bids from being rendered more than once. It should only be enabled after auto-refreshing is implemented correctly.  Default is false. |
 | `suppressExpiredRender` | Optional | Boolean | When true, prevent bids from being rendered if TTL is reached. Default is false.
+| `legacyRender`      | Optional | Boolean | When true, use legacy rendering logic (see [note](#legacyRender))). Default is false. | 
 
 #### Examples
 {: .no_toc}
@@ -1348,6 +1349,22 @@ PBJS performs the following actions when expired rendering is detected.
 
 Expired winning bids will continue to be rendered unless `suppressExpiredRender` is set to true.  Events including `STALE_RENDER` and `BID_WON` are unaffected by this option.
 
+<a id="legacyRender"></a>
+
+#### More on Legacy Rendering
+
+Since Prebid 10.12, [`renderAd`](/dev-docs/publisher-api-reference/renderAd.html) wraps creatives in an additional iframe. This can cause problems for some creatives
+that try to reach the top window and do not expect to find the extra iframe. You may set `legacyRender: true` to revert
+to pre-10.12 rendering logic:
+
+```javascript
+pbjs.setConfig({
+  auctionOptions: {
+    legacyRender: true
+  }
+});
+```
+
 <a name="setConfig-maxNestedIframes"></a>
 
 ### maxNestedIframes

dev-docs/publisher-api-reference/yield.md

@@ -0,0 +1,16 @@
+---
+layout: api_prebidjs
+title: pbjs.yield
+description: yield setting
+sidebarType: 1
+---
+
+Since version 10, [pbjs.processQueue](/dev-docs/publisher-api-reference/processQueue.html) yields the main browser thread after executing each command in the queue, to improve UX (and some related metrics such as [interaction to next paint](https://web.dev/articles/inp)).
+
+You can disable yielding by setting `pbjs.yield` to `false`:
+
+```javascript
+pbjs.yield = false;
+
+pbjs.que.push(/* ... */)
+```