From 6df019a451d14743237eea8a8850d621ac149521 Mon Sep 17 00:00:00 2001 From: Esther Kim Date: Wed, 18 Dec 2024 10:36:54 -0500 Subject: [PATCH 1/3] Update tv_mode.md --- content/en/dashboards/guide/tv_mode.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/dashboards/guide/tv_mode.md b/content/en/dashboards/guide/tv_mode.md index 346cc832590fd..1c3e672f55fde 100644 --- a/content/en/dashboards/guide/tv_mode.md +++ b/content/en/dashboards/guide/tv_mode.md @@ -16,13 +16,13 @@ To ensure that your dashboard displays correctly on a TV, follow these steps: 1. **Design Your Dashboard**: Begin by creating your dashboard in Datadog. Focus on arranging your widgets within the 12-column grid layout that Datadog dashboards utilize. Keep in mind that the aspect ratio of your widgets and the overall dashboard affects how they are displayed in TV mode. 2. **Enable TV mode**: When your dashboard is ready, enable TV mode. Do this while your screen is connected to the TV and in full-screen mode. This step ensures that the dashboard automatically adjusts to fit the TV screen without the need for manual resizing. {{< img src="/dashboards/guide/tv_mode/tv_mode_config_option.png" alt="Enable the TV mode option through the dashboard Configure menu" style="width:100%;" >}} -3. **Optimize Display Settings**: If your dashboard content is not filling the screen edges, you can simulate a large screen by zooming in or out. Use keyboard shortcuts to adjust the browser display before re-entering TV mode, `CMD/CTRL + +(plus)` to zoom in and CMD/CTRL + -(minus)` to zoom out. +3. **Optimize Display Settings**: If your dashboard content is not filling the screen edges, you can simulate a large screen by zooming in or out. Use keyboard shortcuts to adjust the browser display before re-entering TV mode, `CMD/CTRL + +(plus)` to zoom in and CMD/CTRL + -(minus)` to zoom out. **Note**: This solution comes with readability downtimes and can make some fonts smaller and difficult to read from a distance. ## Understanding TV mode limitations While TV mode offers a convenient way to display dashboards, there are certain limitations and considerations: - **12-Column Grid Restriction**: Dashboards in TV mode adhere to a fixed 12-column grid. This can limit the flexibility in stretching content to fill the entire screen width. In high-density mode, the dashboard is split into two grids of 12 columns, and more widgets will expand the dashboard vertically. -- **Aspect Ratio Constraints**: TV mode resizes the dashboard to fit everything on the screen without scrolling, which means an enforced aspect ratio. If the dashboard's height and width are disproportionate, it may result in white spaces on the edges and widgets can appear minimized (zoomed out). To minimize this, design your dashboard with an aspect ratio that closely matches your TV's display. +- **Aspect Ratio Constraints**: TV mode scales down the dashboard to fit everything on the screen without scrolling, which means an enforced aspect ratio. If the dashboard's height and width are disproportionate, it may result in white spaces on the edges and widgets can appear minimized (zoomed out). To minimize this, design your dashboard with an aspect ratio that closely matches your TV's display. - **Content Centering**: Content may be centered on the screen rather than expanding to the edges. This behavior is often due to the fixed grid system and aspect ratio. For a dashboard that fully utilizes screen width, consider switching to a screenboard, which allows finer control over widget positioning. ## Alternative solutions and recommendations From 98e4ae28901bc252573480d2f18d0949dd7b7648 Mon Sep 17 00:00:00 2001 From: Esther Kim Date: Wed, 18 Dec 2024 10:39:16 -0500 Subject: [PATCH 2/3] Update content/en/dashboards/guide/tv_mode.md --- content/en/dashboards/guide/tv_mode.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/dashboards/guide/tv_mode.md b/content/en/dashboards/guide/tv_mode.md index 1c3e672f55fde..3b920c6c38e97 100644 --- a/content/en/dashboards/guide/tv_mode.md +++ b/content/en/dashboards/guide/tv_mode.md @@ -16,7 +16,7 @@ To ensure that your dashboard displays correctly on a TV, follow these steps: 1. **Design Your Dashboard**: Begin by creating your dashboard in Datadog. Focus on arranging your widgets within the 12-column grid layout that Datadog dashboards utilize. Keep in mind that the aspect ratio of your widgets and the overall dashboard affects how they are displayed in TV mode. 2. **Enable TV mode**: When your dashboard is ready, enable TV mode. Do this while your screen is connected to the TV and in full-screen mode. This step ensures that the dashboard automatically adjusts to fit the TV screen without the need for manual resizing. {{< img src="/dashboards/guide/tv_mode/tv_mode_config_option.png" alt="Enable the TV mode option through the dashboard Configure menu" style="width:100%;" >}} -3. **Optimize Display Settings**: If your dashboard content is not filling the screen edges, you can simulate a large screen by zooming in or out. Use keyboard shortcuts to adjust the browser display before re-entering TV mode, `CMD/CTRL + +(plus)` to zoom in and CMD/CTRL + -(minus)` to zoom out. **Note**: This solution comes with readability downtimes and can make some fonts smaller and difficult to read from a distance. +3. **Optimize Display Settings**: If your dashboard content is not filling the screen edges, you can simulate a large screen by zooming in or out. Use keyboard shortcuts to adjust the browser display before re-entering TV mode, `CMD/CTRL + +(plus)` to zoom in and CMD/CTRL + -(minus)` to zoom out. **Note**: This solution comes with readability downsides; it can make some fonts smaller and difficult to read from a distance. ## Understanding TV mode limitations From fb1d7c95a6bbacab34af0d09871347e4501ef624 Mon Sep 17 00:00:00 2001 From: Esther Kim Date: Wed, 18 Dec 2024 16:09:10 -0500 Subject: [PATCH 3/3] Apply suggestions from code review Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com> --- content/en/dashboards/guide/tv_mode.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/dashboards/guide/tv_mode.md b/content/en/dashboards/guide/tv_mode.md index 3b920c6c38e97..6d5c1ec20f891 100644 --- a/content/en/dashboards/guide/tv_mode.md +++ b/content/en/dashboards/guide/tv_mode.md @@ -16,7 +16,7 @@ To ensure that your dashboard displays correctly on a TV, follow these steps: 1. **Design Your Dashboard**: Begin by creating your dashboard in Datadog. Focus on arranging your widgets within the 12-column grid layout that Datadog dashboards utilize. Keep in mind that the aspect ratio of your widgets and the overall dashboard affects how they are displayed in TV mode. 2. **Enable TV mode**: When your dashboard is ready, enable TV mode. Do this while your screen is connected to the TV and in full-screen mode. This step ensures that the dashboard automatically adjusts to fit the TV screen without the need for manual resizing. {{< img src="/dashboards/guide/tv_mode/tv_mode_config_option.png" alt="Enable the TV mode option through the dashboard Configure menu" style="width:100%;" >}} -3. **Optimize Display Settings**: If your dashboard content is not filling the screen edges, you can simulate a large screen by zooming in or out. Use keyboard shortcuts to adjust the browser display before re-entering TV mode, `CMD/CTRL + +(plus)` to zoom in and CMD/CTRL + -(minus)` to zoom out. **Note**: This solution comes with readability downsides; it can make some fonts smaller and difficult to read from a distance. +3. **Optimize Display Settings**: If your dashboard content is not filling the screen edges, you can simulate a large screen by zooming in or out. Use keyboard shortcuts to adjust the browser display before re-entering TV mode, `CMD/CTRL + +(plus)` to zoom in and `CMD/CTRL + -(minus)` to zoom out. **Note**: This solution comes with readability downsides; it can make some fonts smaller and difficult to read from a distance. ## Understanding TV mode limitations