Merge pull request #35 from deneb-viz/1.6

1.6

community/contributors.mdx

@@ -20,115 +20,76 @@ Vega and Vega-Lite are from the work of the [UW Interactive Data Lab (IDL)](http
 
 ### Daniel Marsh-Patrick
 
-<figure class="profile">
-  <figcaption class="figure-caption text-center">
+<div class="profile-section">
+  <div>
     <a
       target="_blank"
       href="https://mvp.microsoft.com/en-us/PublicProfile/5003712?fullName=Daniel%20Marsh-Patrick"
     >
-      <img src="/img/mvp_2020_12.png" height="160px" />
+      <img src="/img/mvp_2020_12.png" height="200px" />
     </a>
-  </figcaption>
-</figure>
-
-<div class="social-links">
-  <p>
-    <a
-      target="_blank"
-      href="https://twitter.com/the_d_mp"
-      class="follow"
-      alt="Follow on Twitter"
-      title="Follow on Twitter"
-    >
-      <FontAwesomeIcon icon={faTwitter} size="lg" /> @the_d_mp
-    </a>
-  </p>
-  <p>
-    <a
-      target="_blank"
-      href="https://www.linkedin.com/in/daniel-m-p/"
-      class="follow"
-      alt="Connect on LinkedIn"
-      title="Connect on LinkedIn"
-    >
-      <FontAwesomeIcon icon={faLinkedin} size="lg" /> daniel-m-p
-    </a>
-  </p>
-  <p>
-    <a
-      target="_blank"
-      href="https://github.com/dm-p"
-      class="follow"
-      alt="Check out on GitHub"
-      title="Check out on GitHub"
-    >
-      <FontAwesomeIcon icon={faGithub} size="lg" /> dm-p
-    </a>
-  </p>
-  <p>
-    <a
-      target="_blank"
-      href="https://coacervo.co"
-      class="follow"
-      alt="Website"
-      title="Website"
-    >
-      <FontAwesomeIcon icon={faGlobe} size="lg" /> coacervo.co
-    </a>
-  </p>
-  <p>
-    <a
-      target="_top"
-      href="mailto:[email protected]?subject=Hi There!"
-      class="follow"
-      alt="Contact via email"
-      title="Contact via email"
-    >
-      <FontAwesomeIcon icon={faEnvelope} size="lg" /> [email protected]
-    </a>
-  </p>
+  </div>
+  <div class="social-links">
+    <div class="social-link">
+      <a
+        target="_blank"
+        href="https://twitter.com/the_d_mp"
+        class="follow"
+        alt="Follow on Twitter"
+        title="Follow on Twitter"
+      >
+        <FontAwesomeIcon icon={faTwitter} size="lg" /> @the_d_mp
+      </a>
+    </div>
+    <div class="social-link">
+      <a
+        target="_blank"
+        href="https://www.linkedin.com/in/daniel-m-p/"
+        class="follow"
+        alt="Connect on LinkedIn"
+        title="Connect on LinkedIn"
+      >
+        <FontAwesomeIcon icon={faLinkedin} size="lg" /> daniel-m-p
+      </a>
+    </div>
+    <div class="social-link">
+      <a
+        target="_blank"
+        href="https://github.com/dm-p"
+        class="follow"
+        alt="Check out on GitHub"
+        title="Check out on GitHub"
+      >
+        <FontAwesomeIcon icon={faGithub} size="lg" /> dm-p
+      </a>
+    </div>
+    <div class="social-link">
+      <a
+        target="_blank"
+        href="https://coacervo.co"
+        class="follow"
+        alt="Website"
+        title="Website"
+      >
+        <FontAwesomeIcon icon={faGlobe} size="lg" /> coacervo.co
+      </a>
+    </div>
+    <div class="social-link">
+      <a
+        target="_top"
+        href="mailto:[email protected]?subject=Hi There!"
+        class="follow"
+        alt="Contact via email"
+        title="Contact via email"
+      >
+        <FontAwesomeIcon icon={faEnvelope} size="lg" /> [email protected]
+      </a>
+    </div>
+  </div>
 </div>
 
-<div class="biography">
-  <p>
-    In addition to working on Deneb, Daniel&nbsp;
-    <a
-      href="https://appsource.microsoft.com/en-us/marketplace/apps?search=marsh-patrick&page=1&product=power-bi-visuals"
-      target="_blank"
-    >
-      contributes a number of free and open-source custom visuals
-    </a>&nbsp; to the Power BI Marketplace.
-  </p>
-  <p>
-    He is extremely passionate about the Microsoft BI stack, particularly Power
-    BI, and has been delivering Power BI solutions since 2014. He is a &nbsp;
-    <a
-      href="https://mvp.microsoft.com/en-us/PublicProfile/5003712?fullName=Daniel%20Marsh-Patrick"
-      target="_blank"
-    >
-      Microsoft Data Platform MVP
-    </a>, a <a
-      href="https://community.powerbi.com/t5/user/viewprofilepage/user-id/397"
-      target="_blank"
-    >
-      Power BI Community Super User
-    </a> and regularly presents and blogs on a variety of Power BI subjects. Daniel
-    is also a Principal Data Analyst with <a
-      href="https://www.discoverei.com/"
-      target="_blank"
-    >
-      DiscoverEI
-    </a>, transforming environmental data into decisions.
-  </p>
-  <p>
-    He has authored the{" "}
-    <a
-      href="https://learn.radacad.com/course/introduction-to-developing-power-bi-visuals/?ref=667"
-      target="_blank"
-    >
-      Introduction to Developing Power BI Visuals
-    </a>{" "}
-    course via RADACAD, to provide a guided learning path for those who wish to
-    learn to develop Power BI Visuals.
-  </p>
-</div>
+In addition to working on Deneb, Daniel [contributes a number of free and open-source custom visuals](https://appsource.microsoft.com/en-us/marketplace/apps?search=marsh-patrick&page=1&product=power-bi-visuals) to the Power BI Marketplace.
+
+He is extremely passionate about the Microsoft BI stack, particularly Power BI, and has been delivering Power BI solutions since 2014. He is a [Microsoft Data Platform MVP](https://mvp.microsoft.com/en-us/PublicProfile/5003712?fullName=Daniel%20Marsh-Patrick), a [Power BI Community Super User](https://community.powerbi.com/t5/user/viewprofilepage/user-id/397) and regularly presents and blogs on a variety of Power BI subjects. Daniel is also a Principal Data Analyst with [DiscoverEI](https://www.discoverei.com/), transforming environmental data into decisions.
+
+He has authored the [Introduction to Developing Power BI Visuals](https://learn.radacad.com/course/introduction-to-developing-power-bi-visuals/?ref=667) course via RADACAD, to provide a guided learning path for those who wish to learn to develop Power BI Visuals.

community/early-access.md

@@ -18,7 +18,7 @@ This process might sound cool, but have a read of the following to determine if
 - Early access builds are provided on the basis for giving feedback to maintainers.
 - They are not supported for production use.
 - Formal documentation is not complete until we're ready to publish, so there may be some degree of discovery required from your end to ascertain changes between builds.
-<!-- - We will do our best to keep up with documenting major things, which is [made available through the 'next' version](/next) on this site. This version of the [Change Log](/next/changelog) will be the best place to start for a simplified digest of what's going on. -->
+- We will do our best to keep up with documenting major things, which is [made available through the 'next' version](/next) on this site. This version of the [Change Log](/next/changelog) will be the best place to start for a simplified digest of what's going on.
 - Early access builds are de-coupled from AppSource, are not certified and do not self-update.
 - Please provide feedback! The privilege of getting access to early builds is a two-way street - and you can really help other users get a better experience when we publish to AppSource by letting us know about things.
 

docs/changelog.md

@@ -5,7 +5,11 @@ description: Deneb Change Log - high-level details of new features and fixes for
 
 # Change Log
 
-## 1.6.0 (Under Development)
+## 1.6.0 (2023-11-01)
+
+:::info Pending Deployment
+Deneb 1.6 has been approved and certified by Microsoft but may take a few days to reach your reports.
+:::
 
 This update concentrates on making changes that improve performance and architecture for the next planned updates. A lot of these were slated for version 2, but this has become too large of a task to do in one go. As such, version 2's scope will change to focus on features that may result in breaking changes for templates and the next few updates will focus on delivering long-awaited or commonly requested features that will improve the UI and productivity experience for creators.
 
@@ -18,7 +22,7 @@ For older versions Power BI Desktop, you can install previous versions of Deneb
 ### Vega Updates
 
 - Vega updated to **5.25.0** (from 5.23.0).
-- Vega-Lite updated to **5.14.1** (from 5.6.1).
+- Vega-Lite updated to **5.16.1** (from 5.6.1).
 
 ### Parsing and Validation Workflow Changes
 
@@ -48,6 +52,15 @@ The key impacts on creators and viewers are as follows:
 
 - Vega parsing would not previously catch errors in the _Logs_ viewer. This has been fixed.
 
+:::info Parsing Changes and Effect on Vega Lite Specifications
+If you created a visual from the previous internal templates, you may see warnings in the **Logs** viewer. This is due to an issue with the way that the previous templates were configured. If you wish to remove these warnings, remove the following objects from your Config (as they relate to Vega only):
+
+- `path`
+- `shape`
+- `symbol`
+
+:::
+
 ### General UI Changes
 
 ![Deneb's Advanced Editor UI has been updated to use the latest Fluent UI libraries from Microsoft. This image shows the main editor view with the new changes.](/img/changelog/1.6.0/new-ui-layout.png "Deneb's Advanced Editor UI has been updated to use the latest Fluent UI libraries from Microsoft. This image shows the main editor view with the new changes.")
@@ -103,7 +116,7 @@ Key changes are as follows:
 - The maximum zoom level has been increased to **400%**.
 - The _Reset Zoom_ button has been removed and replaced with a popover on the zoom level - this allows you to choose a pre-defined or custom zoom level:
 
-  ![The zoom level indicator on the toolbar allow smore finer-grained setting of zoom level of the visual preview.](/img/changelog/1.6.0/new-zoom-popover.png "The zoom level indicator on the toolbar allow smore finer-grained setting of zoom level of the visual preview.")
+  ![The zoom level indicator on the toolbar allows more finer-grained setting of zoom level of the visual preview.](/img/changelog/1.6.0/new-zoom-popover.png "The zoom level indicator on the toolbar allows more finer-grained setting of zoom level of the visual preview.")
 
   Note that the 'reset zoom to 100%' hotkey ([Ctrl+Alt+0]) will still work as intended.
 
@@ -125,11 +138,12 @@ Some new properties have been introduced to the **Rendered visual** menu in the
 
 Additionally, there is a **Show scrollbars on overflow** in the **Advanced editor** menu, that will allow you to preview the scrollbars in the advanced editor, if your visual will overflow the boundaries of the viewport.
 
+This is covered in more detail in the [Scrolling and Overflow](scrolling-overflow) page.
+
 ### Other Enhancements
 
 - The properties pane has been converted to use the new formatting cards that were recently introduced in core visuals.
 - The DIN font has had a more sensible alias assigned (this is known internally as `wf_standard-font`) and can now be specified as 'DIN' wherever you're using it.
-<!-- - As Segoe UI has CSS fallbacks added by default in core visuals, using 'Segoe UI' as a font can cause portability issues on Mac devices (as posted about [here by Meagan Longoria](https://datasavvy.me/2023/08/17/quick-tip-about-fonts-in-deneb-visuals-in-power-bi/)). These fallbacks have been added into Deneb so that just using 'Segoe UI' will now fall back automatically to the fonts specified by Microsoft. -->
 
 ### Bugs Fixed
 
@@ -150,9 +164,9 @@ Additionally, there is a **Show scrollbars on overflow** in the **Advanced edito
 
 - The field name limit for template fields has been increased from 30 to 150 characters.
 
-  :::danger Field name limit relaxations are not backwards compatible
-  If exporting a template with > 30 characters in a field name, it cannot be imported into earler versions and will require you to manually correct the field name in the template JSON if you wish for this to work.
-  :::
+:::danger Field name limit relaxations are not backwards compatible
+If exporting a template with > 30 characters in a field name, it cannot be imported into earler versions and will require you to manually correct the field name in the template JSON if you wish for this to work.
+:::
 
 - The `pbiFormat` expression function has an optional third parameter that can be used to specify additional options that are available to custom visual developers.
 

docs/deeper-concepts/color-schemes.md

@@ -2,7 +2,7 @@
 id: schemes
 description: Using custom Vega schemes in Deneb to bind to the Power BI report theme, as well as accessing Power BI report theme colors in-general.
 slug: /schemes
-title: Theme Colors & Schemes
+title: Theme Colors and Schemes
 ---
 
 Deneb provides some means to bind to your report's current theme, in the form of:

docs/deeper-concepts/performance-considerations.md

@@ -50,18 +50,3 @@ Any data that you add to the visual will have performance implications, specific
 - Creating a row context with lower granularity than you actually need, which can make producing the desired output more challenging.
 
 Therefore, only add the columns and measures (and filter context) that your visual needs to communicate its message.
-
-## The Performance Tuning Property Menu
-
-The **Performance Tuning** menu in the Power BI format pane is used to expose additional properties that you can use to alter performance of your specification. Where possible, these properties are set to what makes the most sense for optimal performance.
-
-### Recalculate During Resize
-
-:::info OFF By Default
-:::
-
-Due to the dynamic nature of Power BI visual containers, any change to the sizing can trigger an update to a visual's logic and this can cause your visual specification to get re-calculated during the process. This may not be noticeable for visuals that use a small amount of marks, but for those that are more complex, this might create more overhead than you need for something you don't do frequently.
-
-If enabled, the **Recalculate during resize** property will continue to calculate any changes to the specification while a visual is in the process of being resized. If disabled, Deneb will delay any further updates until you have completed the resize operation by releasing the mouse button, e.g.:
-
-![recalculate-during-resize.gif.](./img/recalculate-during-resize.gif "Our raincloud plot example contains many data points and calculations, which can be computationally expensive if resizing the visual container. By turning off the 'Recalculate during resize' property, you can delay any calculations until you have finished resizing your visual.")

docs/deeper-concepts/scrolling-overflow.md

@@ -0,0 +1,48 @@
+---
+id: scrolling-overflow
+description: Things to consider when working with large datasets or a large quantity of marks
+slug: /scrolling-overflow
+title: Scrolling and Overflow
+---
+
+# Scrolling and Overflow
+
+By default, Deneb will do its best to fit simple specifications to the visual container. However, there are many scenarios that can and will cause the displayed visual to overflow this container. Such scenarios can include setting the explicit height and/or width of your viewport, working with facets or repeating views, or using an explicit step size for a scale.
+
+## On the Report Canvas
+
+Let's use the step size as an example to demonstrate how this looks. Here, we have too many values on our y-axis, causing our visual to overflow vertically:
+
+![scrolling-simple-overflow](img/scrolling-simple-overflow.png "With a prescribed step size and enough data our visual overflows the Power BI viewport, causing it to display a vertical scroll bar.")
+
+## Configuring Scrollbar Appearance
+
+The **Scrollbars** formatting card in the **Rendered visual** menu in Power BI's formatting pane provides some customization options for the scrollbars:
+
+![scrolling-scrollbar-properties](img/scrolling-scrollbar-properties.png "The Scrollbars formatting card in the Rendered visual menu in Power BI's formatting pane provides some customization options for the scrollbars")
+
+- **Scrollbar color** allows you to tailor the displayed color of the scrollbar.
+
+- **Scrollbar opacity (%)** allows you to tailor the opacity of the scrollbar.
+
+- **Scrollbar radius (px)** allows you to tailor the corder radius of the scrollbar handle.
+
+## In the Visual Editor
+
+When viewing your specification in the Visual Editor's preview area, this is shown relative to the viewport marker (dotted area), so that you can quickly determine the degree of overflow and make any corrections if necessary, e.g.:
+
+![scrolling-editor-overflow-default](img/scrolling-editor-overflow-default.png "The preview area in the Visual Editor will show the full extent of the rendered output")
+
+The preview area will have its own scrollbars as needed, and these also take effect if you zoom the output in to a larger footprint than the available room in the editor.
+
+#### Confirming and Configuring Scrollbar Report Canvas Appearance in the Editor
+
+If you want to see how the visual will appear on the canvas in terms of its scrolling behavior, you can enable the **Show scrollbars on overflow** property in the **Preview area** formatting card in the **Advanced area** property menu:
+
+![scrolling-editor-overflow-property](img/scrolling-editor-overflow-property.png "The Advanced editor > Preview area > Show scrollbars on overflow property allows you to apply the scrollbars (as viewed on the report canvas) to the viewport marker rather than the preview area.")
+
+With this property enabled, Deneb will apply the scrollbars to the viewport marker rather than the preview area, e.g.:
+
+![scrolling-editor-scrollbars-enabled](img/scrolling-editor-scrollbars-enabled.png "The viewport marker with scrollbars applied to it.")
+
+The displayed scrollbars will also use the [appearance configuration](#configuring-scrollbar-appearance) from the **Scrollbars** formatting card, so you can use this option to test this within the editor if so desired.