{"id":131,"date":"2026-01-20T18:14:53","date_gmt":"2026-01-20T18:14:53","guid":{"rendered":"https:\/\/help.ministrycentral-europe.org\/?post_type=epkb_post_type_1&p=131"},"modified":"2026-01-20T18:14:53","modified_gmt":"2026-01-20T18:14:53","slug":"embedding-referencing-video-in-documentation","status":"publish","type":"epkb_post_type_1","link":"https:\/\/help.ministrycentral-europe.org\/?epkb_post_type_1=embedding-referencing-video-in-documentation","title":{"rendered":"Embedding & Referencing Video in Documentation"},"content":{"rendered":"

MinistryCentral Europe<\/strong><\/p>\n

\n

1. Purpose of This Document<\/strong><\/h2>\n

This document defines how video is embedded and referenced<\/strong> within MinistryCentral Europe documentation and learning materials.<\/p>\n

It exists to ensure that:<\/p>\n

    \n
  • Video is used consistently<\/li>\n
  • Canonical documentation remains clear and authoritative<\/li>\n
  • Pages remain performant and readable<\/li>\n
  • Media usage aligns with editorial and platform standards<\/li>\n<\/ul>\n

    This document applies to usage<\/strong>, not hosting or intake.<\/p>\n

    \n

    2. Guiding Principle<\/strong><\/h2>\n

    Video supports documentation \u2014 it does not replace it.<\/p><\/blockquote>\n

    Text remains the primary carrier of meaning, authority, and structure.<\/p>\n

    Video is additive and contextual.<\/p>\n

    \n

    3. Where Video May Be Embedded<\/strong><\/h2>\n

    Video may be embedded in:<\/p>\n

      \n
    • Course lessons (primary teaching)<\/li>\n
    • Supporting instructional sections<\/li>\n
    • Onboarding or orientation guides<\/li>\n
    • Technical walkthroughs (when visual clarity helps)<\/li>\n<\/ul>\n

      Video should not<\/strong> be embedded:<\/p>\n

        \n
      • As a substitute for written instructions<\/li>\n
      • In governance or policy documents<\/li>\n
      • Excessively or decoratively<\/li>\n<\/ul>\n
        \n

        4. Approved Embedding Sources<\/strong><\/h2>\n

        Only the following sources may be embedded:<\/p>\n

          \n
        • Vimeo<\/strong> (canonical instructional content)<\/li>\n
        • Loom<\/strong> (short, supplemental guidance)<\/li>\n<\/ul>\n

          Embeds from:<\/p>\n

            \n
          • YouTube<\/li>\n
          • Personal cloud links<\/li>\n
          • Temporary sources\n

            are not permitted.<\/li>\n<\/ul>\n

            \n

            5. Embedding Standards<\/strong><\/h2>\n

            When embedding video:<\/p>\n

              \n
            • Place video after<\/strong> a section header, not mid-paragraph<\/li>\n
            • Provide a short text introduction explaining:\n
                \n
              • What the video covers<\/li>\n
              • Why it is included<\/li>\n<\/ul>\n<\/li>\n
              • Avoid autoplay<\/li>\n
              • Avoid stacking multiple videos back-to-back without explanation<\/li>\n<\/ul>\n

                Example:<\/p>\n

                The following video demonstrates the lesson structure discussed above.<\/p><\/blockquote>\n

                \n

                6. Referencing Video Without Embedding<\/strong><\/h2>\n

                In some cases, it is preferable to reference<\/strong> video rather than embed it.<\/p>\n

                This is appropriate when:<\/p>\n

                  \n
                • Video is optional<\/li>\n
                • Video is supplementary<\/li>\n
                • Page performance is a concern<\/li>\n<\/ul>\n

                  In such cases:<\/p>\n

                    \n
                  • Provide a clear link<\/li>\n
                  • Indicate expected duration<\/li>\n
                  • Clarify whether viewing is required or optional<\/li>\n<\/ul>\n
                    \n

                    7. Canonical Authority Rule<\/strong><\/h2>\n
                      \n
                    • Embedded video does not<\/strong> create authority<\/li>\n
                    • Canonical text governs meaning<\/li>\n
                    • If video content conflicts with text, text prevails<\/strong><\/li>\n
                    • Video updates do not override documentation without review<\/li>\n<\/ul>\n

                      Editors must ensure alignment.<\/p>\n

                      \n

                      8. Accessibility & Usability<\/strong><\/h2>\n

                      Where feasible:<\/p>\n

                        \n
                      • Videos should include captions<\/li>\n
                      • Audio should be intelligible<\/li>\n
                      • Key points should be summarized in text<\/li>\n<\/ul>\n

                        Documentation must remain usable even if video cannot be viewed.<\/p>\n

                        \n

                        9. Performance Considerations<\/strong><\/h2>\n

                        Avoid:<\/p>\n

                          \n
                        • Autoplay<\/li>\n
                        • Excessive embeds on a single page<\/li>\n
                        • Large numbers of videos without structure<\/li>\n<\/ul>\n

                          Performance degradation is grounds for revision.<\/p>\n

                          \n

                          10. Common Pitfalls to Avoid<\/strong><\/h2>\n
                            \n
                          • \u274c Embedding video without context<\/li>\n
                          • \u274c Replacing instructions with video alone<\/li>\n
                          • \u274c Using video to introduce policy or authority<\/li>\n
                          • \u274c Embedding unapproved sources<\/li>\n
                          • \u274c Ignoring page readability<\/li>\n<\/ul>\n
                            \n

                            11. Relationship to Other Documents<\/strong><\/h2>\n

                            This document works with:<\/p>\n

                              \n
                            • Video Usage Policy<\/strong><\/li>\n
                            • Media Intake & Naming Standards<\/strong><\/li>\n
                            • Formatting & Style Guidelines<\/strong><\/li>\n
                            • Documentation Workflow<\/strong><\/li>\n<\/ul>\n

                              It does not define hosting, intake, or governance.<\/p>\n

                              \n

                              12. Summary<\/strong><\/h2>\n
                                \n
                              • Embed video deliberately<\/li>\n
                              • Always pair video with explanatory text<\/li>\n
                              • Use approved platforms only<\/li>\n
                              • Preserve canonical authority in writing<\/li>\n
                              • Optimize for clarity, not media density<\/li>\n<\/ul>\n

                                <\/p>\n","protected":false},"excerpt":{"rendered":"

                                MinistryCentral Europe 1. Purpose of This Document This document defines how video is embedded and referenced within MinistryCentral Europe documentation […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"default","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"set","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"epkb_post_type_1_category":[3],"epkb_post_type_1_tag":[],"class_list":["post-131","epkb_post_type_1","type-epkb_post_type_1","status-publish","hentry","epkb_post_type_1_category-ops_contrib"],"_links":{"self":[{"href":"https:\/\/help.ministrycentral-europe.org\/index.php?rest_route=\/wp\/v2\/epkb_post_type_1\/131","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.ministrycentral-europe.org\/index.php?rest_route=\/wp\/v2\/epkb_post_type_1"}],"about":[{"href":"https:\/\/help.ministrycentral-europe.org\/index.php?rest_route=\/wp\/v2\/types\/epkb_post_type_1"}],"author":[{"embeddable":true,"href":"https:\/\/help.ministrycentral-europe.org\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/help.ministrycentral-europe.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=131"}],"version-history":[{"count":1,"href":"https:\/\/help.ministrycentral-europe.org\/index.php?rest_route=\/wp\/v2\/epkb_post_type_1\/131\/revisions"}],"predecessor-version":[{"id":132,"href":"https:\/\/help.ministrycentral-europe.org\/index.php?rest_route=\/wp\/v2\/epkb_post_type_1\/131\/revisions\/132"}],"wp:attachment":[{"href":"https:\/\/help.ministrycentral-europe.org\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=131"}],"wp:term":[{"taxonomy":"epkb_post_type_1_category","embeddable":true,"href":"https:\/\/help.ministrycentral-europe.org\/index.php?rest_route=%2Fwp%2Fv2%2Fepkb_post_type_1_category&post=131"},{"taxonomy":"epkb_post_type_1_tag","embeddable":true,"href":"https:\/\/help.ministrycentral-europe.org\/index.php?rest_route=%2Fwp%2Fv2%2Fepkb_post_type_1_tag&post=131"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}