{"id":1253,"date":"2008-03-25T00:02:11","date_gmt":"2008-03-24T22:02:11","guid":{"rendered":"http:\/\/vizZzion.org\/blog\/2008\/03\/all-ur-changelog-r-belong-to-us\/"},"modified":"2008-03-25T00:02:11","modified_gmt":"2008-03-24T22:02:11","slug":"all-ur-changelog-r-belong-to-us","status":"publish","type":"post","link":"https:\/\/vizZzion.org\/blog\/2008\/03\/all-ur-changelog-r-belong-to-us\/","title":{"rendered":"All ur ChangeLog r belong to us."},"content":{"rendered":"<p>We (marketing \/ promo hat on) are right now trying to write the announcement for KDE 4.0.3,<br \/>\n    which will be released on April 2nd, a bit more than a week from now. Let&#8217;s have a look at how<br \/>\n    this actually works, and zoom in on the bugfix \/ translation updates that 4.0.x releases are.<br \/>\n    The announcement is usually written by a subset of the Marketing Team, coordination takes place<br \/>\n    on the kde-promo mailinglist. On this list, people that are willing and able to write about KDE<br \/>\n    hang out. Those people are collecting information about those releases. For a big thing such as<br \/>\n    KDE 4.0, this is relatively easy, there&#8217;s more than enough to talk about. For an update release<br \/>\n    (such as next week&#8217;s) we&#8217;re mostly relying on the changelog as raw material. We try to form an<br \/>\n    impression of what&#8217;s happened in branch in that period, and munge that into something which is<br \/>\n    readable for human beings and provides a high-level summary for those that won&#8217;t dive into<br \/>\n    details. Then, the original announcement version is written and ASAP (though usually too late)<br \/>\n    sent to the translation teams so we have a multi-language announcement ready on release day.<br \/>\n    The trade-off here is: Writing the announcement earlier, the changelog will be incomplete, but<br \/>\n    the translation teams get more time, so we end up having more and better translations on<br \/>\n    release day. Writing the announcement later, there&#8217;s more in the changelog (although<br \/>\n    unfortunately not much more :\/) but the translation teams have too little time, so we lack<br \/>\n    translations. Having a more complete changelog available earlier is the solution to this<br \/>\n    problem. So we need help from developers. Kudos at this point go out to the KHTML and Okular<br \/>\n    teams, who, from the top of my head, usually have done their changelog homework well.<\/p>\n<p \/>\n    For the lazy ones among us (most, assumably), here&#8217;s what you do (assuming you use svn+ssh,<br \/>\n    https users will what to change):<\/p>\n<pre>\nsvn co svn+ssh:\/\/svn.kde.org\/home\/kde\/trunk\/www\/sites\/www\/announcements\/changelogs\nkwrite changelogs\/changelog_branch_4_0.xml<\/pre>\n<p>    Scroll down to a line that looks like <em>&lt;release version=&#8221;4.0.3&#8243; date=&#8221;2008-0?-??&#8221;&gt;<\/em>, scroll<br \/>\n    down a bit more, to the part containing the module and product your changes went in, and add them.<br \/>\n    You can use the tags bugfix <bugfix rev=\"12341234\"\\>, improvement &lt;improvement rev=&#8221;&#8221;&gt;, feature &lt;feature rev=&#8221;&#8221;&gt; or whatever is<br \/>\n    documented in the <a href=\"http:\/\/www.kde.org\/announcements\/changelogs\/DOCS\">DOCS<\/a>. In practise,<br \/>\n    it&#8217;ll be a bit of copy\/pasting. Commit your changes and have a smile on your face when you read<br \/>\n    about your improvements in the announcement a few days later.<br \/>\n    If you want to see what you&#8217;ve done, run the following on the changelog and see your<br \/>\n    changes put into the webpages:<\/p>\n<pre>\nxsltproc --stringparam outputversion \"4.0.3\" -o changelog4_0_2to4_0_3.php\nchangelog.xsl changelog_branch_4_0.xml<\/pre>\n<p>I think this ignoring of the changelog is a display of a culture that we see quite often<br \/>\n    within KDE. A culture that is very humble and fully concentrates on getting work done. Only in<br \/>\n    this case, it causes problems for others that also want to get their work (informing about KDE)<br \/>\n    done. So if you changed something in the KDE 4.0 branch between 27th of February and 26th March<br \/>\n    (this coming Wednesday) please support the Marketing Team&#8217;s work by adding your change to the<br \/>\n    changelog. Remember, if a change is worth backporting, it&#8217;s worth putting in the changelog. The<br \/>\n    more entries there are in the changelog, the more choice the Marketing Team has to streamline the<br \/>\n    message. Of course, also the &#8216;raw&#8217; changelog will be available to the users, usually linked from<br \/>\n    the announcement on www.kde.org and multiple other sites reporting about KDE 4.0.3. Users will<br \/>\n    look for their pet issue being addressed. The Marketing Team does an awesome job in communicating<br \/>\n    what&#8217;s happening (who doesn&#8217;t love reading the Commit-Digest for example?), but they can&#8217;t do<br \/>\n    that on their own. Please spend those 5 minutes and help your fellow gearhead.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>We (marketing \/ promo hat on) are right now trying to write the announcement for KDE 4.0.3, which will be released on April 2nd, a bit more than a week from now. Let&#8217;s have a look at how this actually works, and zoom in on the bugfix \/ translation updates that 4.0.x releases are. The&hellip; <a class=\"more-link\" href=\"https:\/\/vizZzion.org\/blog\/2008\/03\/all-ur-changelog-r-belong-to-us\/\">Continue reading <span class=\"screen-reader-text\">All ur ChangeLog r belong to us.<\/span> <span class=\"meta-nav\" aria-hidden=\"true\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[29],"tags":[],"class_list":["post-1253","post","type-post","status-publish","format-standard","hentry","category-kde"],"_links":{"self":[{"href":"https:\/\/vizZzion.org\/blog\/wp-json\/wp\/v2\/posts\/1253","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vizZzion.org\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/vizZzion.org\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/vizZzion.org\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/vizZzion.org\/blog\/wp-json\/wp\/v2\/comments?post=1253"}],"version-history":[{"count":0,"href":"https:\/\/vizZzion.org\/blog\/wp-json\/wp\/v2\/posts\/1253\/revisions"}],"wp:attachment":[{"href":"https:\/\/vizZzion.org\/blog\/wp-json\/wp\/v2\/media?parent=1253"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/vizZzion.org\/blog\/wp-json\/wp\/v2\/categories?post=1253"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/vizZzion.org\/blog\/wp-json\/wp\/v2\/tags?post=1253"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}