{"id":624,"date":"2013-06-12T13:51:00","date_gmt":"2013-06-12T20:51:00","guid":{"rendered":"http:\/\/pln.lanecc.net\/webteam\/?p=624"},"modified":"2013-06-12T13:51:00","modified_gmt":"2013-06-12T20:51:00","slug":"the-importance-of-revisioning","status":"publish","type":"post","link":"https:\/\/blogs.lanecc.edu\/webteam\/2013\/06\/12\/the-importance-of-revisioning\/","title":{"rendered":"The Importance of Revisioning"},"content":{"rendered":"<p>When you&#8217;re editing one of our Drupal pages, you may have noticed a little tab down at the bottom, right above the save button:<\/p>\n<p><a href=\"http:\/\/blogs.lanecc.edu\/webteam\/wp-content\/uploads\/sites\/25\/2013\/06\/pretabs.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-625\" alt=\"A picture of the bottom of our Drupal Edit screen. Of note is the &quot;Revision Information&quot; tab which defaults to closed.\" src=\"http:\/\/blogs.lanecc.edu\/webteam\/wp-content\/uploads\/sites\/25\/2013\/06\/pretabs.png\" width=\"696\" height=\"568\" srcset=\"https:\/\/blogs.lanecc.edu\/webteam\/wp-content\/uploads\/sites\/25\/2013\/06\/pretabs.png 696w, https:\/\/blogs.lanecc.edu\/webteam\/wp-content\/uploads\/sites\/25\/2013\/06\/pretabs-300x244.png 300w, https:\/\/blogs.lanecc.edu\/webteam\/wp-content\/uploads\/sites\/25\/2013\/06\/pretabs-624x509.png 624w\" sizes=\"auto, (max-width: 709px) 85vw, (max-width: 909px) 67vw, (max-width: 984px) 61vw, (max-width: 1362px) 45vw, 600px\" \/><\/a>See that little grey box? The one that says &#8220;Revision Information&#8221;? That&#8217;s actually a very helpful box. In there, you&#8217;ll find a place to enter a revision log message, where you can describe the changes you made to the page, like this:<\/p>\n<p><a href=\"http:\/\/blogs.lanecc.edu\/webteam\/wp-content\/uploads\/sites\/25\/2013\/06\/withrevisionmessage.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-626\" alt=\"Shows a revision message added to a node: &quot;Modified the header style&quot;\" src=\"http:\/\/blogs.lanecc.edu\/webteam\/wp-content\/uploads\/sites\/25\/2013\/06\/withrevisionmessage.png\" width=\"626\" height=\"414\" srcset=\"https:\/\/blogs.lanecc.edu\/webteam\/wp-content\/uploads\/sites\/25\/2013\/06\/withrevisionmessage.png 626w, https:\/\/blogs.lanecc.edu\/webteam\/wp-content\/uploads\/sites\/25\/2013\/06\/withrevisionmessage-300x198.png 300w, https:\/\/blogs.lanecc.edu\/webteam\/wp-content\/uploads\/sites\/25\/2013\/06\/withrevisionmessage-624x412.png 624w\" sizes=\"auto, (max-width: 709px) 85vw, (max-width: 909px) 67vw, (max-width: 984px) 61vw, (max-width: 1362px) 45vw, 600px\" \/><\/a>You may not have been aware, but if you click on the revisions tab at the top of a page, you can get a list of who made changes, and when those changes were made. If everyone also includes revision log messages, then we can also, at a glance, see <em>what<\/em> was changed. And that can be super helpful:<\/p>\n<figure id=\"attachment_627\" aria-describedby=\"caption-attachment-627\" style=\"width: 609px\" class=\"wp-caption aligncenter\"><a href=\"http:\/\/blogs.lanecc.edu\/webteam\/wp-content\/uploads\/sites\/25\/2013\/06\/revisionlog.png\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-627\" alt=\"The revision log for our sample node, at the top is the revision made in the previous picture, including the message left. Other revisions didn't have a message.\" src=\"http:\/\/blogs.lanecc.edu\/webteam\/wp-content\/uploads\/sites\/25\/2013\/06\/revisionlog.png\" width=\"609\" height=\"254\" srcset=\"https:\/\/blogs.lanecc.edu\/webteam\/wp-content\/uploads\/sites\/25\/2013\/06\/revisionlog.png 609w, https:\/\/blogs.lanecc.edu\/webteam\/wp-content\/uploads\/sites\/25\/2013\/06\/revisionlog-300x125.png 300w\" sizes=\"auto, (max-width: 709px) 85vw, (max-width: 909px) 67vw, (max-width: 984px) 61vw, (max-width: 1362px) 45vw, 600px\" \/><\/a><figcaption id=\"caption-attachment-627\" class=\"wp-caption-text\">Unfortunately, this example may be a case of &#8220;Do as I say, not as I do&#8221;<\/figcaption><\/figure>\n<p>As you can see, the first 4 revisions, by me, have no revision message. It&#8217;s very difficult to see at a glance what changes I made, or why I made them. But the most recent message, &#8220;Modified the Header Style&#8221; tells you exactly what I changed.<\/p>\n<p>If we wanted an ever better message, we could have written &#8220;Changed page header from a paragraph to an H2, in accordance with the guidelines provided by the webteam&#8221;. Then we&#8217;d know not only what was changed, but why.<\/p>\n<p>So revisions are awesome, right? But they work best when everyone uses them, so that if I modify your page, you&#8217;ll know what I did, and I&#8217;ll know what you did before me. For that reason, this weekend we&#8217;ll be turning on a module that enforces a revision log message. In other words, if you forget to enter a revision message, you&#8217;ll get a nasty red message that highlights the revision message box and asks you to fill it in. Please take the time to write a brief, meaningful message. It&#8217;ll help everyone out.<\/p>\n<p>This change is part of a broader set of changes we&#8217;re hoping to make to the Drupal editing experience to allow more flexible workflows. Expect more details in the upcoming weeks!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>When you&#8217;re editing one of our Drupal pages, you may have noticed a little tab down at the bottom, right above the save button: See that little grey box? The one that says &#8220;Revision Information&#8221;? That&#8217;s actually a very helpful box. In there, you&#8217;ll find a place to enter a revision log message, where you &hellip; <a href=\"https:\/\/blogs.lanecc.edu\/webteam\/2013\/06\/12\/the-importance-of-revisioning\/\" class=\"more-link\">Continue reading<span class=\"screen-reader-text\"> &#8220;The Importance of Revisioning&#8221;<\/span><\/a><\/p>\n","protected":false},"author":43,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"ngg_post_thumbnail":0,"footnotes":"","_wpscppro_dont_share_socialmedia":false,"_wpscppro_custom_social_share_image":0,"_facebook_share_type":"","_twitter_share_type":"","_linkedin_share_type":"","_pinterest_share_type":"","_linkedin_share_type_page":"","_instagram_share_type":"","_medium_share_type":"","_threads_share_type":"","_google_business_share_type":"","_selected_social_profile":[],"_wpsp_enable_custom_social_template":false,"_wpsp_social_scheduling":{"enabled":false,"datetime":null,"platforms":[],"status":"template_only","dateOption":"today","timeOption":"now","customDays":"","customHours":"","customDate":"","customTime":"","schedulingType":"absolute"},"_wpsp_active_default_template":true},"categories":[3],"tags":[7,25],"class_list":["post-624","post","type-post","status-publish","format-standard","hentry","category-drupal","tag-best-practices","tag-drupal"],"_links":{"self":[{"href":"https:\/\/blogs.lanecc.edu\/webteam\/wp-json\/wp\/v2\/posts\/624","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blogs.lanecc.edu\/webteam\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blogs.lanecc.edu\/webteam\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blogs.lanecc.edu\/webteam\/wp-json\/wp\/v2\/users\/43"}],"replies":[{"embeddable":true,"href":"https:\/\/blogs.lanecc.edu\/webteam\/wp-json\/wp\/v2\/comments?post=624"}],"version-history":[{"count":0,"href":"https:\/\/blogs.lanecc.edu\/webteam\/wp-json\/wp\/v2\/posts\/624\/revisions"}],"wp:attachment":[{"href":"https:\/\/blogs.lanecc.edu\/webteam\/wp-json\/wp\/v2\/media?parent=624"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blogs.lanecc.edu\/webteam\/wp-json\/wp\/v2\/categories?post=624"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blogs.lanecc.edu\/webteam\/wp-json\/wp\/v2\/tags?post=624"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}