A tutorial on how to add a new version of an existing article.

<!doctype html>  <html class="no-js" lang="en">  <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="alternate" type="application/rss+xml" title="Latest packages" href="//our.umbraco.com/rss/projects" /> <link rel="alternate" type="application/rss+xml" title="Package updates" href="//our.umbraco.com/rss/projectsupdate" /> <link rel="alternate" type="application/rss+xml" title="Active forum topics" href="//our.umbraco.com/rss/activetopics" /> <link rel="search" type="application/opensearchdescription+xml" title="our.umbraco.com" href="/scripts/OpenSearch.xml">  <meta name="application-name" content="Our Umbraco" /> <meta name="apple-mobile-web-app-title" content="Our Umbraco">  <link rel="apple-touch-icon-precomposed" href="/assets/images/app-icons/icon-60.png"> <link rel="apple-touch-icon-precomposed" sizes="72x72" href="/assets/images/app-icons/icon-72.png"> <link rel="apple-touch-icon-precomposed" sizes="76x76" href="/assets/images/app-icons/icon-76.png"> <link rel="icon" sizes="192x192" href="/assets/images/app-icons/touch-icon-192x192.png"> <meta name="msapplication-TileImage" content="/assets/images/app-icons/tile.png" /> <meta name="msapplication-config" content="/assets/images/app-icons/browserconfig.xml"> <link rel="icon" type="image/png" href="/assets/images/app-icons/favicon.png"> <meta name="robots" content="noindex"> <title>A tutorial on how to add a new version of an existing article. - Our Umbraco</title> <meta name="description" content="Through a very detailed tutorial learn all the steps involved with creating a new version of an article in the Umbraco Docs and how to target it for a specific version of Umbraco." /> <link rel="canonical" href="https://docs.umbraco.com/contribute/how-to-add-a-new-version/" /> <script type="text/javascript" src="/scripts/jquery-1.9.1.min.js"></script>  <script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start': new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0], j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src= 'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f); })(window,document,'script','dataLayer','GTM-W9TZ2XW');</script>  <link href="/DependencyHandler.axd?s=L2Fzc2V0cy9jc3Mvc3R5bGUubWluLmNzczs&t=Css&cdv=25020301" type="text/css" rel="stylesheet"/><link href="https://cdnjs.cloudflare.com/ajax/libs/fancybox/3.1.20/jquery.fancybox.min.css" type="text/css" rel="stylesheet"/> </head> <body class="wiki-page">  <noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-W9TZ2XW" height="0" width="0" style="display: none; visibility: hidden"></iframe></noscript>  <div class="quick-menu"> <div class="container"> <div class="row"> <div class="col-md-12"> <a href="/member/login">Sign in</a> <a href="/member/Signup">Register</a> </div> </div> </div> </div> <div class="wrapper"> <header> <div class="navigation"> <div class="container"> <div class="row"> <div class="col-md-3"> <a class="logo" href="/">Our Umbraco</a> </div> <div id="toggle" class="menu-toggle"> <a href="#" class="toggle cross"><span></span></a> </div> <nav class="col-md-9"> <ul> <li> <a href="/forum/">Forum</a> </li> <li> <a href="/packages/">Packages</a> </li> <li class="current"> <a href="/documentation/">Documentation</a> </li> <li> <a href="https://community.umbraco.com/">Community</a> </li> <li> <a href="https://discord.umbraco.com/">Discord</a> </li> <li> <a href="/download/">Download</a> </li> <li> <a href="/member/login?redirectUrl=%2fdocumentation%2fContribute%2fHow-to-add-a-new-version%2f">Sign in</a><strong> / </strong><a href="/member/Signup">Register</a> </li> </ul> </nav> </div> </div> </div> </header> <div class="has-sidebar"> <div class="documentation"> <div class="page-content"> <div class="sidebar-area"> <div class="sidebar-content"> <div class="content-wrapper"> <nav> <details class="secondary_nav" open> <summary>Menu</summary> <ul class="level-1"> <li class=""> <a href="/documentation/Getting-Started/"><h3>Getting Started</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Getting-Started/Managing-an-Umbraco-project/"><h4>Managing an Umbraco project</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Getting-Started/Editing-websites-with-Umbraco/"><h4>Editing websites with Umbraco</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Getting-Started/Creating-websites-with-Umbraco/"><h4>Creating websites with Umbraco</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Getting-Started/Developing-websites-with-Umbraco/"><h4>Developing websites with Umbraco</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Getting-Started/Developing-websites-with-Umbraco/Customizing-Umbraco-sites/"><h5>Customizing Umbraco sites</h5></a></li> <li class=""><a href="/documentation/Getting-Started/Developing-websites-with-Umbraco/Extending-the-Umbraco-Backoffice/"><h5>Extending the Umbraco Backoffice</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Getting-Started/Hosting-an-Umbraco-infrastructure/"><h4>Hosting an Umbraco infrastructure</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Getting-Started/Where-can-I-get-help/"><h4>Where can I get help</h4></a> <ul class="level-3 "> </ul> </li> </ul> </li> <li class=""> <a href="/documentation/Fundamentals/"><h3>Fundamentals</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Fundamentals/Setup/"><h4>Setup</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Fundamentals/Setup/Requirements/"><h5>Requirements</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Setup/Install/"><h5>Install</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Setup/Upgrading/"><h5>Upgrading</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Setup/Server-Setup/"><h5>Server Setup</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Fundamentals/Backoffice/"><h4>Backoffice</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Fundamentals/Backoffice/Sections/"><h5>Sections</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Backoffice/Property-Editors/"><h5>Property Editors</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Backoffice/Login/"><h5>Login</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Backoffice/Content-Templates/"><h5>Content Templates</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Backoffice/Infinite-editing/"><h5>Infinite editing</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Backoffice/LogViewer/"><h5>LogViewer</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Backoffice/Variants/"><h5>Variants</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Fundamentals/Data/"><h4>Data</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Fundamentals/Data/Defining-content/"><h5>Defining content</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Creating-Media/"><h5>Creating Media</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Members/"><h5>Members</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Data-Types/"><h5>Data Types</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Scheduled-Publishing/"><h5>Scheduled Publishing</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Adding-Tabs/"><h5>Adding Tabs</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Dictionary-Items/"><h5>Dictionary Items</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Relations/"><h5>Relations</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Data/Users/"><h5>Users</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Fundamentals/Design/"><h4>Design</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Fundamentals/Design/Templates/"><h5>Templates</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Design/Rendering-Content/"><h5>Rendering Content</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Design/Rendering-Media/"><h5>Rendering Media</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Design/Stylesheets-Javascript/"><h5>Stylesheets Javascript</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Design/Partial-View-Macro-Files/"><h5>Partial View Macro Files</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Design/Partial-Views/"><h5>Partial Views</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Fundamentals/Code/"><h4>Code</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Fundamentals/Code/Umbraco-Services/"><h5>Umbraco Services</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Code/Subscribing-To-Events/"><h5>Subscribing To Events</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Code/Creating-Forms/"><h5>Creating Forms</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Code/Debugging/"><h5>Debugging</h5></a></li> <li class=""><a href="/documentation/Fundamentals/Code/Source-Control/"><h5>Source Control</h5></a></li> </ul> </li> </ul> </li> <li class=""> <a href="/documentation/Implementation/"><h3>Implementation</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Implementation/Default-Routing/"><h4>Default Routing</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Implementation/Default-Routing/Inbound-Pipeline/"><h5>Inbound Pipeline</h5></a></li> <li class=""><a href="/documentation/Implementation/Default-Routing/Controller-Selection/"><h5>Controller Selection</h5></a></li> <li class=""><a href="/documentation/Implementation/Default-Routing/Execute-Request/"><h5>Execute Request</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Implementation/Custom-Routing/"><h4>Custom Routing</h4></a> </li> <li class=""> <a href="/documentation/Implementation/Controllers/"><h4>Controllers</h4></a> </li> <li class=""> <a href="/documentation/Implementation/Data-Persistence/"><h4>Data Persistence</h4></a> </li> <li class=""> <a href="/documentation/Implementation/Rest-Api/"><h4>Rest Api</h4></a> </li> <li class=""> <a href="/documentation/Implementation/Composing/"><h4>Composing</h4></a> </li> <li class=""> <a href="/documentation/Implementation/Services/"><h4>Services</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Implementation/Services/Circular-Dependencies/"><h5>Circular Dependencies</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Implementation/Unit-Testing/"><h4>Unit Testing</h4></a> </li> </ul> </li> <li class=""> <a href="/documentation/Extending/"><h3>Extending</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Extending/Dashboards/"><h4>Dashboards</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Extending/Section-Trees/"><h4>Section Trees</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Extending/Section-Trees/Searchable-Trees/"><h5>Searchable Trees</h5></a></li> <li class=""><a href="/documentation/Extending/Section-Trees/Sections/"><h5>Sections</h5></a></li> <li class=""><a href="/documentation/Extending/Section-Trees/Trees/"><h5>Trees</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Extending/Property-Editors/"><h4>Property Editors</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Extending/Property-Editors/Build-a-Block-Editor/"><h5>Build a Block Editor</h5></a></li> <li class=""><a href="/documentation/Extending/Property-Editors/Package-Manifest/"><h5>Package Manifest</h5></a></li> <li class=""><a href="/documentation/Extending/Property-Editors/Property-Actions/"><h5>Property Actions</h5></a></li> <li class=""><a href="/documentation/Extending/Property-Editors/Property-Value-Converters/"><h5>Property Value Converters</h5></a></li> <li class=""><a href="/documentation/Extending/Property-Editors/Tracking/"><h5>Tracking</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Extending/Macro-Parameter-Editors/"><h4>Macro Parameter Editors</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Extending/Health-Check/"><h4>Health Check</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Extending/Health-Check/Guides/"><h5>Guides</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Extending/Language-Files/"><h4>Language Files</h4></a> </li> <li class=""> <a href="/documentation/Extending/Backoffice-Search/"><h4>Backoffice Search</h4></a> </li> <li class=""> <a href="/documentation/Extending/Backoffice-Tours/"><h4>Backoffice Tours</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Extending/Backoffice-UI-API-Documentation/"><h4>Backoffice UI API Documentation</h4></a> </li> <li class=""> <a href="/documentation/Extending/Content-Apps/"><h4>Content Apps</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Extending/Database/"><h4>Database</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Extending/Embedded-Media-Provider/"><h4>Embedded Media Provider</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Extending/FileSystemProviders/"><h4>FileSystemProviders</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Extending/FileSystemProviders/Azure-Blob-Storage/"><h5>Azure Blob Storage</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Extending/Packages/"><h4>Packages</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Extending/Packages/Creating-a-nuget-package/"><h5>Creating a nuget package</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Creating-a-Package/"><h5>Creating a Package</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Language-Files-For-Packages/"><h5>Language Files For Packages</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Maintaining-Packages/"><h5>Maintaining Packages</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Package-Actions/"><h5>Package Actions</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Packages-on-Umbraco-Cloud/"><h5>Packages on Umbraco Cloud</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Types-of-Packages/"><h5>Types of Packages</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/UmbPack/"><h5>UmbPack</h5></a></li> <li class=""><a href="/documentation/Extending/Packages/Uploading-to-Our/"><h5>Uploading to Our</h5></a></li> </ul> </li> </ul> </li> <li class=""> <a href="/documentation/Reference/"><h3>Reference</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/"><h4>Configuration for Umbraco 7 and 8</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/404handlers/"><h5>404handlers</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/applications/"><h5>applications</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/BaseRestExtensions/"><h5>BaseRestExtensions</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/dashboard/"><h5>dashboard</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/EmbeddedMedia/"><h5>EmbeddedMedia</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/ExamineIndex/"><h5>ExamineIndex</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/ExamineSettings/"><h5>ExamineSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/fileSystemProviders/"><h5>fileSystemProviders</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/HealthChecks/"><h5>HealthChecks</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/Serilog/"><h5>Serilog</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/tinyMceConfig/"><h5>tinyMceConfig</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/trees/"><h5>trees</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/umbracoSettings/"><h5>umbracoSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration-for-Umbraco-7-and-8/webconfig/"><h5>webconfig</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Templating/"><h4>Templating</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Templating/Macros/"><h5>Macros</h5></a></li> <li class=""><a href="/documentation/Reference/Templating/Masterpages/"><h5>Masterpages</h5></a></li> <li class=""><a href="/documentation/Reference/Templating/Modelsbuilder/"><h5>Modelsbuilder</h5></a></li> <li class=""><a href="/documentation/Reference/Templating/Mvc/"><h5>Mvc</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Querying/"><h4>Querying</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Querying/DynamicPublishedContent/"><h5>DynamicPublishedContent</h5></a></li> <li class=""><a href="/documentation/Reference/Querying/IPublishedContent/"><h5>IPublishedContent</h5></a></li> <li class=""><a href="/documentation/Reference/Querying/MemberShipHelper/"><h5>MemberShipHelper</h5></a></li> <li class=""><a href="/documentation/Reference/Querying/UmbracoHelper/"><h5>UmbracoHelper</h5></a></li> <li class=""><a href="/documentation/Reference/Querying/UDI-identifiers/"><h5>UDI identifiers</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Routing/"><h4>Routing</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Routing/Authorized/"><h5>Authorized</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/IISRewriteRules/"><h5>IISRewriteRules</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/Request-Pipeline/"><h5>Request Pipeline</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/URL-Tracking/"><h5>URL Tracking</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/Custom-Controllers/"><h5>Custom Controllers</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/Custom-Routes/"><h5>Custom Routes</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/Routing-Properties/"><h5>Routing Properties</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/Surface-Controllers/"><h5>Surface Controllers</h5></a></li> <li class=""><a href="/documentation/Reference/Routing/Umbraco-API-Controllers/"><h5>Umbraco API Controllers</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Searching/"><h4>Searching</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Searching/Examine/"><h5>Examine</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Events/"><h4>Events</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Events/EditorModel-Events/"><h5>EditorModel Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/MemberService-Events/"><h5>MemberService Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/ContentService-Events/"><h5>ContentService Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/ContentTypeService-Events/"><h5>ContentTypeService Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/DataTypeService-Events/"><h5>DataTypeService Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/FileService-Events/"><h5>FileService Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/LocalizationService-Events/"><h5>LocalizationService Events</h5></a></li> <li class=""><a href="/documentation/Reference/Events/MediaService-Events/"><h5>MediaService Events</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Management/"><h4>Management</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Management/Models/"><h5>Models</h5></a></li> <li class=""><a href="/documentation/Reference/Management/Services/"><h5>Services</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Plugins/"><h4>Plugins</h4></a> </li> <li class=""> <a href="/documentation/Reference/Cache/"><h4>Cache</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Cache/Application-Cache/"><h5>Application Cache</h5></a></li> <li class=""><a href="/documentation/Reference/Cache/Examples/"><h5>Examples</h5></a></li> <li class=""><a href="/documentation/Reference/Cache/ICacheRefresher/"><h5>ICacheRefresher</h5></a></li> <li class=""><a href="/documentation/Reference/Cache/Updating-Cache/"><h5>Updating Cache</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Security/"><h4>Security</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Security/Authenticate-with-Active-Directory/"><h5>Authenticate with Active Directory</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Auto-linking/"><h5>Auto linking</h5></a></li> <li class=""><a href="/documentation/Reference/Security/BackOfficeUserManager-and-Notifications/"><h5>BackOfficeUserManager and Notifications</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Custom-password-check/"><h5>Custom password check</h5></a></li> <li class=""><a href="/documentation/Reference/Security/External-login-providers/"><h5>External login providers</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Reset-admin-password/"><h5>Reset admin password</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Security-hardening/"><h5>Security hardening</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Security-settings/"><h5>Security settings</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Sensitive-data-on-members/"><h5>Sensitive data on members</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Serverside-sanitizing/"><h5>Serverside sanitizing</h5></a></li> <li class=""><a href="/documentation/Reference/Security/Setup-Umbraco-for-a-Fips-Server/"><h5>Setup Umbraco for a Fips Server</h5></a></li> <li class=""><a href="/documentation/Reference/Security/SSL-HTTPS/"><h5>SSL HTTPS</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/Common-Pitfalls/"><h4>Common Pitfalls</h4></a> </li> <li class=""> <a href="/documentation/Reference/Angular/"><h4>Angular</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Angular/Directives/"><h5>Directives</h5></a></li> <li class=""><a href="/documentation/Reference/Angular/Services/"><h5>Services</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Reference/API-Documentation/"><h4>API Documentation</h4></a> </li> <li class=""> <a href="/documentation/Reference/Debugging/"><h4>Debugging</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Reference/Language-Variation/"><h4>Language Variation</h4></a> </li> <li class=""> <a href="/documentation/Reference/Mapping/"><h4>Mapping</h4></a> </li> <li class=""> <a href="/documentation/Reference/Notifications/"><h4>Notifications</h4></a> </li> <li class=""> <a href="/documentation/Reference/Scheduling/"><h4>Scheduling</h4></a> </li> <li class=""> <a href="/documentation/Reference/Using-Ioc/"><h4>Using Ioc</h4></a> </li> <li class=""> <a href="/documentation/Reference/Configuration/"><h4>Configuration</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Reference/Configuration/BasicAuthSettings/"><h5>BasicAuthSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ConnectionStringsSettings/"><h5>ConnectionStringsSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ContentDashboard/"><h5>ContentDashboard</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ContentSettings/"><h5>ContentSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/DataTypes/"><h5>DataTypes</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/DebugSettings/"><h5>DebugSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ExceptionFilterSettings/"><h5>ExceptionFilterSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/GlobalSettings/"><h5>GlobalSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/HostingSettings/"><h5>HostingSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ImagingSettings/"><h5>ImagingSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/InstallDefaultDataSettings/"><h5>InstallDefaultDataSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/KeepAliveSettings/"><h5>KeepAliveSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/LoggingSettings/"><h5>LoggingSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/MaximumUploadSizeSettings/"><h5>MaximumUploadSizeSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ModelsBuilderSettings/"><h5>ModelsBuilderSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/NuCacheSettings/"><h5>NuCacheSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/PackageMigrationSettings/"><h5>PackageMigrationSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/PluginsSettings/"><h5>PluginsSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/RequestHandlerSettings/"><h5>RequestHandlerSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/RichTextEditorSettings/"><h5>RichTextEditorSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/RuntimeMinificationSettings/"><h5>RuntimeMinificationSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/RuntimeSettings/"><h5>RuntimeSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/SecuritySettings/"><h5>SecuritySettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/ToursSettings/"><h5>ToursSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/TypeFinderSettings/"><h5>TypeFinderSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/UnattendedSettings/"><h5>UnattendedSettings</h5></a></li> <li class=""><a href="/documentation/Reference/Configuration/WebRoutingSettings/"><h5>WebRoutingSettings</h5></a></li> </ul> </li> </ul> </li> <li class=""> <a href="/documentation/Tutorials/"><h3>Tutorials</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Tutorials/Creating-Basic-Site/"><h4>Creating Basic Site</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Getting-Started/"><h5>Getting Started</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Document-Types/"><h5>Document Types</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Creating-Your-First-Template-and-Content-Node/"><h5>Creating Your First Template and Content Node</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/CSS-And-Images/"><h5>CSS And Images</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Displaying-the-Document-Type-Properties/"><h5>Displaying the Document Type Properties</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Creating-Master-Template-Part-1/"><h5>Creating Master Template Part 1</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Creating-Master-Template-Part-2/"><h5>Creating Master Template Part 2</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Setting-The-Navigation-Menu/"><h5>Setting The Navigation Menu</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Articles-Parent-and-Article-Items/"><h5>Articles Parent and Article Items</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Adding-Language-Variants/"><h5>Adding Language Variants</h5></a></li> <li class=""><a href="/documentation/Tutorials/Creating-Basic-Site/Conclusions-Where-Next/"><h5>Conclusions Where Next</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Creating-a-Custom-Dashboard/"><h4>Creating a Custom Dashboard</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Creating-a-Property-Editor/"><h4>Creating a Property Editor</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Multilanguage-Setup/"><h4>Multilanguage Setup</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Starter-kit/"><h4>Starter kit</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Tutorials/Starter-kit/Lessons/"><h5>Lessons</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Editors-Manual/"><h4>Editors Manual</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Tutorials/Editors-Manual/Getting-Started-With-Umbraco/"><h5>Getting Started With Umbraco</h5></a></li> <li class=""><a href="/documentation/Tutorials/Editors-Manual/Working-with-Content/"><h5>Working with Content</h5></a></li> <li class=""><a href="/documentation/Tutorials/Editors-Manual/Version-Management/"><h5>Version Management</h5></a></li> <li class=""><a href="/documentation/Tutorials/Editors-Manual/Media-Management/"><h5>Media Management</h5></a></li> <li class=""><a href="/documentation/Tutorials/Editors-Manual/Tips-and-Tricks/"><h5>Tips and Tricks</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Add-Google-Authentication/"><h4>Add Google Authentication</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Connecting-Umbraco-Forms-and-Zapier/"><h4>Connecting Umbraco Forms and Zapier</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Creating-an-XML-Site-Map/"><h4>Creating an XML Site Map</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Creating-and-distributing-a-package/"><h4>Creating and distributing a package</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Creating-Custom-Views-for-Blocklist/"><h4>Creating Custom Views for Blocklist</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Creating-Tables-for-Umbraco-with-PetaPoco/"><h4>Creating Tables for Umbraco with PetaPoco</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Custom-Error-Pages/"><h4>Custom Error Pages</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Members-Registration-And-Logins/"><h4>Members Registration And Logins</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Multisite-Setup/"><h4>Multisite Setup</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Tutorials/Porting-Packages-V8/"><h4>Porting Packages V8</h4></a> </li> </ul> </li> <li class=""> <a href="/documentation/Add-ons/"><h3>Add ons</h3></a> <ul class="level-2 "> <li class=""> <a href="/documentation/Add-ons/UmbracoForms/"><h4>UmbracoForms</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Add-ons/UmbracoForms/Installation/"><h5>Installation</h5></a></li> <li class=""><a href="/documentation/Add-ons/UmbracoForms/Editor/"><h5>Editor</h5></a></li> <li class=""><a href="/documentation/Add-ons/UmbracoForms/Developer/"><h5>Developer</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Add-ons/Umbraco-Deploy/"><h4>Umbraco Deploy</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Get-Started-with-Deploy/"><h5>Get Started with Deploy</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Installing-Deploy/"><h5>Installing Deploy</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Deployment-Workflow/"><h5>Deployment Workflow</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Deploy-Settings/"><h5>Deploy Settings</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Upgrades/"><h5>Upgrades</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Troubleshooting/"><h5>Troubleshooting</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Deploy/Extending/"><h5>Extending</h5></a></li> </ul> </li> <li class=""> <a href="/documentation/Add-ons/The-Licensing-model/"><h4>The Licensing model</h4></a> <ul class="level-3 "> </ul> </li> <li class=""> <a href="/documentation/Add-ons/Umbraco-Plumber/"><h4>Umbraco Plumber</h4></a> <ul class="level-3 "> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Approval-Groups/"><h5>Approval Groups</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Dashboards-and-Buttons/"><h5>Dashboards and Buttons</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Email-Templates/"><h5>Email Templates</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Events/"><h5>Events</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Getting-Started/"><h5>Getting Started</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Installing-Plumber/"><h5>Installing Plumber</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Licensing/"><h5>Licensing</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Notifications-and-Reminders/"><h5>Notifications and Reminders</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Upgrading-Plumber/"><h5>Upgrading Plumber</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Workflow-Content-App/"><h5>Workflow Content App</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Workflow-History/"><h5>Workflow History</h5></a></li> <li class=""><a href="/documentation/Add-ons/Umbraco-Plumber/Workflow-Settings/"><h5>Workflow Settings</h5></a></li> </ul> </li> </ul> </li> <li class="active open"> <a href="/documentation/Contribute/"><h3>Contribute</h3></a> <ul class="level-2 open"> <li class=""> <a href="/documentation/Contribute/Adding-Metadata/"><h4>Adding Metadata</h4></a> </li> <li class=""> <a href="/documentation/Contribute/Code-samples/"><h4>Code samples</h4></a> <ul class="level-3 open"> </ul> </li> <li class=""> <a href="/documentation/Contribute/DocsTemplates/"><h4>DocsTemplates</h4></a> </li> <li class=""> <a href="/documentation/Contribute/File-Naming-Conventions/"><h4>File Naming Conventions</h4></a> </li> <li class="active open"> <a href="/documentation/Contribute/How-to-add-a-new-version/"><h4>How to add a new version</h4></a> <ul class="level-3 open"> </ul> </li> <li class=""> <a href="/documentation/Contribute/Issues/"><h4>Issues</h4></a> <ul class="level-3 open"> </ul> </li> <li class=""> <a href="/documentation/Contribute/Markdown-Conventions/"><h4>Markdown Conventions</h4></a> <ul class="level-3 open"> </ul> </li> <li class=""> <a href="/documentation/Contribute/Pull-Requests/"><h4>Pull Requests</h4></a> <ul class="level-3 open"> </ul> </li> <li class=""> <a href="/documentation/Contribute/Style-Guide/"><h4>Style Guide</h4></a> <ul class="level-3 open"> </ul> </li> </ul> </li> </ul> </details> </nav> </div> </div> </div> <div class="main-area"> <div class="main-content"> <div class="content-wrapper"> <div> <div class="utilities"> <ul id="breadcrumb"> <li><a href="/">Our</a></li> <li><a href="/documentation/">Documentation</a></li> <li><a href="/documentation/Contribute/">Contribute</a></li> <li><a href="/documentation/Contribute/How-to-add-a-new-version/">How to add a new version</a></li> </ul> </div> </div> <div style="width: 100%;" class="alertbar__red"> <h1 style="color: black; font-size: 50px; text-align: center; line-height: 50px; text-decoration: underline;">We have moved!</h1> <p style="font-size:20px; text-align: center; line-height: 50px;">You are currently looking at documentation for Umbraco 8 and older versions. <br> <span>An automated guess is that <a href="https://docs.umbraco.com/contribute/how-to-add-a-new-version/">docs.umbraco.com/contribute/how-to-add-a-new-version/</a> could be the link to the new documentation for Umbraco 9 and newer versions.</span> </p> </div> <div class="search-big"> <div class="textSearch"> <input type="search" class="docs-search-input" required placeholder="Search for documentation"> <label for="search">Search for documentation</label> </div> </div> <ul class="search-all-results docs-search-listing"></ul> <div id="markdown-docs" class="docs-default-listing markdown-syntax"> <style> #markdown-docs .anchorjs-link { color: #ff6e00 !important; font-size: 20px !important; text-decoration: none !important; } #markdown-docs a.offset-anchor { visibility: hidden; position: relative; top: -100px; display: block; } </style> <script type="text/javascript" src="/scripts/anchorjs/anchorjs.custom.js"></script> <script type="text/javascript"> $(document).ready(function () { anchors.options = { placement: 'left', visible: "hover", anchorCreated: function (e) { var id = $(e).attr('id'); //clear it's id since we'll be creating a custom anchor point with an offset $(e).removeAttr("id"); $(e).addClass("anchorjs-heading"); $(e).prepend("<a class='offset-anchor' id='" + id + "'></a>"); } }; anchors.add('.markdown-syntax h1, .markdown-syntax h2, .markdown-syntax h3, .markdown-syntax h4, .markdown-syntax h5, .markdown-syntax h5'); var element = $(window.location.hash); if (element.length === 1) { setTimeout(function () { //hightlight it element.closest(".anchorjs-heading").css("color", "#ff6e00"); element.closest(".anchorjs-heading").find("a").not(".anchorjs-link").css("color", "#ff6e00"); }, 100); } $("#markdown-docs .anchorjs-link").click(function () { if (element.length === 1) { //un hightlight it element.closest(".anchorjs-heading").css("color", "inherit"); element.closest(".anchorjs-heading").find("a").not(".anchorjs-link").css("color", "inherit"); } }); }); </script> <aside> <div class="info-box docs-version-panel"> <dl> <dt>Versions</dt> <dd class="current-version selected-version"> 8.0.0 + </dd> </dl> </div> </aside> <h1 id="how-to-add-a-new-version-of-an-article">How to add a new version of an article</h1> <p>This tutorial will guide you through the steps it takes to add a new version of an existing article in the Umbraco Documentation.</p> <div class="tip"><p>The <strong>current major version</strong> on the Umbraco Documentation is currently set to Umbraco 8 (v8). This means that any content that isn't targetting a specific version will be recognized as v8 content.</p> <p>If you want to help out with <strong>updating our documentation against Umbraco 9</strong> you can find more details about that process in the <a href="#umbraco-9-documentation" rel="nofollow">Umbraco 9 Documentation</a> section at the bottom of this article.</p> </div> <h2 id="contents">Contents</h2> <ul> <li><a href="#prerequisites" rel="nofollow">Prerequisites</a></li> <li><a href="#forking-and-cloning-the-documentation-repository" rel="nofollow">Forking and cloning the documentation repository</a></li> <li><a href="#creating-the-new-article" rel="nofollow">Creating the new article</a></li> <li><a href="#adding-labels-to-the-article" rel="nofollow">Adding labels to the article</a></li> <li><a href="#updating-the-content" rel="nofollow">Updating the content</a></li> <li><a href="#creating-the-pr" rel="nofollow">Creating the PR</a></li> <li><a href="#umbraco-9-documentation" rel="nofollow">Umbraco 9 Documentation</a></li> <li><a href="#example-creating-a-new-version-of-indexmd-targetting-an-upcoming-version-Umbraco-9" rel="nofollow">Example: Creating a new version of an article targetting Umbraco 9</a></li> </ul> <h2 id="video-tutorial">Video tutorial</h2> <iframe width="800" height="450" title="Contributing to Umbraco: Documentation and versioning" src="https://www.youtube.com/embed/j81pNEMMA8c?rel=0" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe> <h2 id="prerequisites">Prerequisites</h2> <p>To work with and contribute to the Umbraco Documentation there are a few tools and extensions we recommend that you use. Using these tools will ensure consistency throughout the documentation as well as help you create the best possible version of the article.</p> <ul> <li>Visual Studio Code (VS Code)</li> <li>Markdown linter - Extension for VS Code</li> <li>Vale - Extension for VS Code</li> </ul> <p>We also highly recommend that you're familiar with Git and the Markdown syntax.</p> <h2 id="forking-and-cloning-the-documentation-repository">Forking and cloning the documentation repository</h2> <p>The first step is to get the documentation files down to your local machine, so you can start working with them. This is done by forking the UmbracoDocs repository and cloning it to your local machine.</p> <ol> <li>Follow our guide on <a href="../Pull-Requests/#options-2-creating-a-pr-through-a-fork" rel="nofollow">how to fork the UmbracoDocs repository</a>.</li> <li>Clone your fork to your local machine or open using GitHub Desktop.</li> </ol> <p><img src="images/clone-your-fork.png" alt="Click on 'Code' to get the option to copy the clone URL." /></p> <p>Once you have a local clone of the UmbracoDocs repository on your local machine, open the entire <code>UmbracoDocs/</code> folder using your favorite editor.</p> <p>We recommend using Visual Studio Code as it can be extended with a lot of useful tools for writing documentation.</p> <h2 id="creating-the-new-article">Creating the new article</h2> <p>Now it's time to create the new article. Depending on the article and the version of Umbraco you will be targetting, these are the two most common scenarios:</p> <ul> <li>The article is targetting an older Umbraco version and you want to create a new version of the article that targets the <em>current major version</em>, or</li> <li>You want to target a version of Umbraco that has not been released yet.</li> </ul> <p>Each scenario involves a different set of steps, which are explained below.</p> <div class="tip"><p>Check out the <a href="../File-Naming-Conventions/#target-a-specific-umbraco-version-using-file-naming-conventions" rel="nofollow">File Naming Conventions</a> to learn more about how to use file names to target a specific version of Umbraco when creating a new article.</p> </div> <h3 id="target-the-current-major-version">Target the current major version</h3> <ol> <li>Create a copy of the existing article, e.g. <code>index.md</code>.</li> <li>Place the new file in the same folder as the aricle you copied.</li> <li>Rename the <em>old</em> article to target the version it was written for, e.g. <code>index-vX.md</code> - <code>X</code> being the <em>old</em> version, e.g. 7.</li> <li>Rename the new article <code>index.md</code>.</li> </ol> <p>You will now have (at least) two versions of the same article: one named <code>index-v7</code>, which is targetting Umbraco 7, and one named <code>index</code>, which will target the current major version.</p> <div class="tip"><p>If you're unsure which Umbraco version to target the <em>old</em> article for, check the <code>versionFrom</code> label inside the article, at the very top.</p> </div> <h3 id="target-an-upcoming-version">Target an upcoming version</h3> <ol> <li>Create a copy of the existing article, e.g. <code>index.md</code>.</li> <li>Place the new file in the same folder as the aricle you copied.</li> <li>Rename the new article based on the Umbraco version that you want to target, e.g. <code>index-vX.md</code> - <code>X</code> being the next major version, e.g. 9.</li> </ol> <p>You will now have (at least) two versions of the same article. One named <code>index</code> which is targetting the current major version, and one named <code>index-vX</code> which is targetting the upcoming Umbraco X version.</p> <h2 id="adding-labels-to-the-article">Adding labels to the article</h2> <p>You've now created a new version of an article and have used the file naming conventions to target the correct Umbraco version.</p> <p>The targetted Umbraco version also needs to be added to the <strong>metadata</strong> in the article itself.</p> <ol> <li>Open the new article.</li> <li>Locate the <code>versionFrom</code> label in the metadata section at the very top of the article.</li> <li>Update the version number to match the version you're targetting.</li> </ol> <p>Example:</p> <div class="highlight"><pre>--- versionFrom: 9.0.0 meta.Title: "Installing Umbraco" meta.Description: "Instructions on installing Umbraco: in VS code, via NuGet or on a Mac" ---</pre></div> <p>In some cases, you might also want to update the <code>meta.Title</code> and <code>meta.Description</code> labels.</p> <p>See the <a href="#metadata-requirements" rel="nofollow">Umbraco 9 Metadata requirements</a> section for more details on which metadata to use when verifying material for Umbraco 9.</p> <h2 id="updating-the-content">Updating the content</h2> <p>With the metadata in place, it is time to start verifying and updating the content in the article.</p> <p>Here's a list of the most common tasks involved with updating an article.</p> <ul> <li>Update any text that is not correct for the new version.</li> <li>Verify and update all code samples and code snippets.</li> <li>Test and verify that any links in the article is targetting the same version.</li> <li>Update any images and screenshots that are/will be outdated.</li> </ul> <div class="tip"><p>All images for an article is stored in an <code>/images</code> folder located in the same file structure level at the article.</p> <p>When adding new images, use the same file naming conventions as for the article itself.</p> </div> <h2 id="creating-the-pr">Creating the PR</h2> <p>Now that you've created a new article and verified and updated the contents for the targeted Umbraco version, it is time to hand in the contribution.</p> <p>This is done, by submitted a Pull Request (PR) on the UmbracoDocs repository.</p> <ol> <li>Commit and push the changes you've made to your own fork of the UmbracoDocs repository.</li> <li>Open your UmbracoDocs fork on Github.</li> <li>Select "Pull request". <img src="images/submit-a-pull-request.png" alt="Select 'Pull request' to start the process of submitting the PR" /></li> <li>Verify that the correct files are part of the PR.</li> <li>Select "Create pull request".</li> <li>Give the PR a descriptive Title.</li> <li>Use the comment section for adding notes to your contribution, asking questions or describing any issues you might have encountered along the way.</li> <li>Select "Create pull request" again to finalize the process and submit the PR.</li> </ol> <p>Once your PR has been created you can expect an answer from one of the UmbracoDocs maintainers within 48 hours (during business hours).</p> <h2 id="umbraco-9-documentation">Umbraco 9 Documentation</h2> <p>To make the process of verifying and updating the documentation for Umbraco 9 as transparent and inclusive as possible, we're maintaining a set of lists of the sections and articles that needs to be worked on.</p> <p>Following the links below, you will find lists for each of the main sections in the Umbraco Documentation.</p> <ul> <li><a href="https://docs.google.com/spreadsheets/d/1SBMsjreht5rMnHysADmYMcjHFWLcAl9LzFbsSIZNxys/edit?usp=sharing" rel="nofollow">Getting Started</a></li> <li><a href="https://docs.google.com/spreadsheets/d/1r5zfT5D5N4kbZjq6YubAZLu7eXjERJh2JsALfXujuQk/edit?usp=sharing" rel="nofollow">Implementation</a></li> <li><a href="https://docs.google.com/spreadsheets/d/1g-Zwn_D4I2EQvzDwsC6_ycjkT4ny6KIBdRY40swnuSo/edit?usp=sharing" rel="nofollow">Extending</a></li> <li><a href="https://docs.google.com/spreadsheets/d/1YyARbCbLKhqR12cfbATxyCEZ6fYYxwBXeOw-jNUyWXc/edit?usp=sharing" rel="nofollow">Reference</a></li> <li><a href="https://docs.google.com/spreadsheets/d/1ya7-ss1WeqHBfpRm3hICRHyZDLAO7UeP1kMwbTmjvb8/edit?usp=sharing" rel="nofollow">Tutorials</a></li> </ul> <p>Please note that the Add-ons sections as well as the sections related to our Cloud products are not included in the lists above.</p> <p>Head on over to the <a href="https://github.com/umbraco/UmbracoDocs/issues/3145" rel="nofollow"><strong>Issue Tracker on the UmbracoDocs repository on Github</strong></a> to see how you can get involved and help us get all the documentation verified and updated for Umbraco 9.</p> <h3 id="metadata-requirements">Metadata requirements</h3> <p>As Umbraco 9 is still in development it is subject to change over the coming months. In order to ensure that any documentation written before the official release of the product will be kept up to date, we've implemented a set of metadata to help us identify various parameters for each article.</p> <table> <thead> <tr> <th>Label</th> <th>Input options</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>state</code></td> <td><code>partial</code> / <code>complete</code> / <code>outline</code></td> <td>Is that article complete? Is it only partially done, or is it simply an outline as a starting point?</td> </tr> <tr> <td><code>verified-against</code></td> <td><code>alpha-4</code> / <code>beta-1</code></td> <td>Define which Umbraco 9 release the article has been verified against.</td> </tr> <tr> <td><code>versionFrom</code></td> <td><code>9.0.0</code></td> <td>Will determine the Umbraco version the article targets.</td> </tr> <tr> <td><code>updated-links</code></td> <td><code>true</code> / <code>false</code></td> <td>As we start to migrate the documentation to Umbraco 9, it will not be possible to convert all links in the articles on the first go. This tag should be used to indicate whether the links in the article have been updated or not.</td> </tr> </tbody> </table> <div class="tip"><h3 id="example-creating-a-new-version-of-indexmd-targetting-an-upcoming-version-umbraco-9">Example: Creating a new version of <code>index.md</code> targetting an upcoming version, Umbraco 9</h3> <p>In this example, we'll be using the steps above to create a new version of an <code>index.md</code> file. The scenario is, that the existing article is already targetting the <em>current major version</em> and we want to create a new version that targets an upcoming version, Umbraco 9.</p> <ol> <li>Create a copy of the <code>index.md</code> file.</li> <li>Rename the new file to <code>index-v9.md</code>.</li> <li>Update the <code>versionFrom</code> metadata to <code>9.0.0</code></li> <li>Verify and update the contents of the article.</li> <li>Use the <code>state</code> metadata to indicate whether or not the article has been fully verified.</li> <li>Use the <code>verified-against</code> metadata to indicate which beta release you've verified the article against.</li> <li>Use the <code>updated-links</code> metadata to tell us whether or not the links have been checked and updated as well.</li> </ol> </div> </div> </div> </div> </div> </div> <script type="text/template" class="search-item-docs"> <li> <a href="{{ url }}"> <div class="type-icon"> <i class="icon-Book-alt"></i> </div> <div class="type-context"> <div class="type-name"> {{ name }} </div> <div class="type-description"> {{ body }} </div> </div> </a> </li> </script> </div> </div> <footer> <div class="container is-narrow-tablet"> <div class="row"> <div class="col-xs-12"> <p><a href="/code-of-conduct">Code Of Conduct</a> - <a href="/privacy-policy">Privacy Policy</a></p> <p> </p> Our.umbraco.com is the community mothership for <a href="https://umbraco.com" target="_blank" rel="noopener noreferrer">Umbraco</a>, the open source asp.net cms. With a friendly forum for all your questions, a comprehensive documentation and a ton of packages from the community. </div> </div> </div> </footer> </div>  <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery-validate/1.13.1/jquery.validate.min.js" type="text/javascript"></script><script src="https://ajax.aspnetcdn.com/ajax/mvc/4.0/jquery.validate.unobtrusive.min.js" type="text/javascript"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/pagedown/1.0/Markdown.Converter.js" type="text/javascript"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/pagedown/1.0/Markdown.Editor.js" type="text/javascript"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/pagedown/1.0/Markdown.Sanitizer.js" type="text/javascript"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/mustache.js/0.8.1/mustache.min.js" type="text/javascript"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/fancybox/3.1.20/jquery.fancybox.min.js" type="text/javascript"></script><script src="/DependencyHandler.axd?s=L2Fzc2V0cy9qcy9qcXVlcnkuYWpheGZpbGV1cGxvYWQuanM7L2Fzc2V0cy9qcy9qcXVlcnkuc2Nyb2xseS5qczsvYXNzZXRzL2pzL2xvZGFzaC5taW4uanM7L2Fzc2V0cy9qcy9jb21tdW5pdHkuanM7L2Fzc2V0cy9qcy9hcHAubWluLmpzOy9hc3NldHMvanMvZWRpdG9yLm1pbi5qczs&t=Javascript&cdv=25020301" type="text/javascript"></script> </body> </html>

CINXE.COM

A tutorial on how to add a new version of an existing article. - Our Umbraco