<!-- 
RSS generated by JIRA (9.4.2#940002-sha1:46d1a51de284217efdcb32434eab47a99af2938b) at Mon Feb 12 01:11:16 CET 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary append 'field=key&field=summary' to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>Magnolia - Issue tracker</title>
    <link>https://jira.magnolia-cms.com</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-uk</language>    <build-info>
        <version>9.4.2</version>
        <build-number>940002</build-number>
        <build-date>19-01-2023</build-date>
    </build-info>


<item>
            <title>[DOCU-663] Refresh/Improve documentation of module version handling</title>
                <link>https://jira.magnolia-cms.com/browse/DOCU-663</link>
                <project id="10190" key="DOCU">Documentation</project>
                    <description>&lt;p&gt;Currently, version handling only seems to be covered by &lt;a href=&quot;https://documentation.magnolia-cms.com/display/DOCS45/Module+management#Modulemanagement-Moduleversionhandling&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;a Magnolia 4.5 Doc page&lt;/a&gt; and &lt;a href=&quot;https://wiki.magnolia-cms.com/display/WIKI/Handling+module+versions&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;a wiki entry from 2011&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;Even though not much has changed technically, it would probably make sense to integrate this information in the latest doc.&lt;/p&gt;

&lt;p&gt;One particular detail missing in the old docs is the fact that version handling only works for up to 3 parts (see &lt;a href=&quot;https://jira.magnolia-cms.com/browse/SUPPORT-5576&quot; class=&quot;external-link&quot; rel=&quot;nofollow&quot;&gt;https://jira.magnolia-cms.com/browse/SUPPORT-5576&lt;/a&gt;). It would be great to have this mentioned somewhere.&lt;/p&gt;</description>
                <environment></environment>
        <key id="49860">DOCU-663</key>
            <summary>Refresh/Improve documentation of module version handling</summary>
                <type id="4" iconUrl="https://jira.magnolia-cms.com/secure/viewavatar?size=xsmall&amp;avatarId=10890&amp;avatarType=issuetype">Improvement</type>
                                            <priority id="6" iconUrl="https://jira.magnolia-cms.com/images/icons/priorities/neutral.gif">Neutral</priority>
                        <status id="6" iconUrl="https://jira.magnolia-cms.com/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are not closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="success"/>
                                    <resolution id="11">Done</resolution>
                                        <assignee username="rgange">Richard Gange</assignee>
                                    <reporter username="creichenbach">Cedric Reichenbach</reporter>
                        <labels>
                    </labels>
                <created>Tue, 19 Jan 2016 15:35:06 +0100</created>
                <updated>Wed, 30 Oct 2019 09:30:56 +0100</updated>
                            <resolved>Wed, 30 Oct 2019 09:28:10 +0100</resolved>
                                                    <fixVersion>5.5</fixVersion>
                    <fixVersion>5.6</fixVersion>
                    <fixVersion>5.7</fixVersion>
                    <fixVersion>6.0</fixVersion>
                    <fixVersion>6.1</fixVersion>
                    <fixVersion>5.4</fixVersion>
                    <fixVersion>6.2</fixVersion>
                                        <due></due>
                            <votes>0</votes>
                                    <watches>5</watches>
                                                    <progress percentage="100">
                                    <originalProgress>
                                                    <row percentage="0" backgroundColor="#89afd7"/>
                                                    <row percentage="100" backgroundColor="transparent"/>
                                            </originalProgress>
                                                    <currentProgress>
                                                    <row percentage="100" backgroundColor="#51a825"/>
                                                    <row percentage="0" backgroundColor="#ec8e00"/>
                                            </currentProgress>
                            </progress>
                                    <aggregateprogress percentage="100">
                                    <originalProgress>
                                                    <row percentage="0" backgroundColor="#89afd7"/>
                                                    <row percentage="100" backgroundColor="transparent"/>
                                            </originalProgress>
                                                    <currentProgress>
                                                    <row percentage="100" backgroundColor="#51a825"/>
                                                    <row percentage="0" backgroundColor="#ec8e00"/>
                                            </currentProgress>
                            </aggregateprogress>
                                            <timeestimate seconds="0">0d</timeestimate>
                            <timespent seconds="1200">20m</timespent>
                                <comments>
                            <comment id="135734" author="ahietala" created="Thu, 1 Dec 2016 13:37:10 +0100"  >&lt;p&gt;Version handling is documented in latest Magnolia CORE docs in &lt;a href=&quot;https://documentation.magnolia-cms.com/display/DOCS/XML-based+module+descriptor#XML-basedmoduledescriptor-Moduleversions&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Module versions&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;However, the fact that the numbering scheme only supports up to three positions (1.2.3) should be added. Versions below the 3rd position are not observed: 1.2.3.4. &lt;/p&gt;</comment>
                            <comment id="135760" author="cmeier" created="Fri, 2 Dec 2016 02:42:47 +0100"  >&lt;p&gt;First, yeah, we have to mention that only &lt;tt&gt;x.y.z&lt;/tt&gt; is possible.&lt;br/&gt;
2nd: Indeed the documentation for version handling in general is very narrow! And &lt;a href=&quot;https://jira.magnolia-cms.com/secure/ViewProfile.jspa?name=cringele&quot; class=&quot;user-hover&quot; rel=&quot;cringele&quot;&gt;cringele&lt;/a&gt; is asking at least since ~2 or 3 years to come with something more useful on documentation. &lt;br/&gt;
So, to really make it &quot;good&quot;, it should be more then just mentioning the behavior. (But it is a huge topic!) &lt;/p&gt;</comment>
                            <comment id="198281" author="czimmermann" created="Thu, 26 Sep 2019 15:18:32 +0200"  >&lt;p&gt;I don&apos;t see module version handlers documentation there.&lt;/p&gt;

&lt;p&gt;We should also add where it makes to use YAML instead of configuration workspace and how this makes migration much easier.&lt;/p&gt;</comment>
                            <comment id="201041" author="rgange" created="Wed, 30 Oct 2019 09:25:49 +0100"  >&lt;p&gt;I added the note as Cedric suggest.&lt;br/&gt;
&lt;span class=&quot;image-wrap&quot; style=&quot;&quot;&gt;&lt;a id=&quot;59320_thumb&quot; href=&quot;https://jira.magnolia-cms.com/secure/attachment/59320/59320_versions.png&quot; title=&quot;versions.png&quot; file-preview-type=&quot;image&quot; file-preview-id=&quot;59320&quot; file-preview-title=&quot;versions.png&quot;&gt;&lt;img src=&quot;https://jira.magnolia-cms.com/secure/thumbnail/59320/_thumb_59320.png&quot; style=&quot;border: 0px solid black&quot; role=&quot;presentation&quot;/&gt;&lt;/a&gt;&lt;/span&gt; &lt;/p&gt;

&lt;p&gt;As for these other two points that were mentioned:&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;&lt;blockquote&gt;&lt;p&gt;2nd: Indeed the documentation for version handling in general is very narrow! And Christian Ringele is asking at least since ~2 or 3 years to come with something more useful on documentation.&lt;br/&gt;
So, to really make it &quot;good&quot;, it should be more then just mentioning the behavior. (But it is a huge topic!)&lt;/p&gt;&lt;/blockquote&gt;&lt;/li&gt;
	&lt;li&gt;&lt;blockquote&gt;&lt;p&gt;We should also add where it makes to use YAML instead of configuration workspace and how this makes migration much easier.&lt;/p&gt;&lt;/blockquote&gt;&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;I&apos;m not sure I have enough information on what is expected. If I have missed something please create some follow up tickets. &lt;/p&gt;</comment>
                            <comment id="201043" author="rgange" created="Wed, 30 Oct 2019 09:30:56 +0100"  >&lt;p&gt;Btw we do have &lt;a href=&quot;https://documentation.magnolia-cms.com/display/DOCS53/Maintaining+your+module&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;this&lt;/a&gt; older docu on version handling. Perhaps we should bring that back? I&apos;m just not sure how relevant that still is. &lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10010">
                    <name>relation</name>
                                            <outwardlinks description="is related to">
                                                        </outwardlinks>
                                                        </issuelinktype>
                    </issuelinks>
                <attachments>
                            <attachment id="59320" name="versions.png" size="118125" author="rgange" created="Wed, 30 Oct 2019 09:22:37 +0100"/>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                            <customfield id="customfield_14166" key="com.okapya.jira.checklist:checklist">
                        <customfieldname>Acceptance criteria</customfieldname>
                        <customfieldvalues>
                            
        <checklist>
        <![CDATA[
                            




                
                                    <div class="o-completion" style="display: flex; flex-shrink: 0;"><span  class="aui-lozenge aui-lozenge-complete" style="font-size: 12px; font-weight: normal; display: flex; flex-direction: row; align-items: center;" ><span style="padding-right: 4px; vertical-align: middle;"><svg width="15" height="15" viewBox="0 0 15 15" xmlns="http://www.w3.org/2000/svg" fill="white"><path clip-rule="evenodd" d="m10.41037,3.42544l-7.86501,0c-0.72395,0 -1.31084,0.58688 -1.31084,1.31084l0,7.86508c0,0.7239 0.58689,1.3108 1.31084,1.3108l7.86501,0c0.724,0 1.3109,-0.5869 1.3109,-1.3108l0,-7.86508c0,-0.72396 -0.5869,-1.31084 -1.3109,-1.31084zm-7.86501,-0.65542c-1.08593,0 -1.96626,0.88032 -1.96626,1.96626l0,7.86508c0,1.0859 0.88033,1.9662 1.96626,1.9662l7.86501,0c1.086,0 1.9663,-0.8803 1.9663,-1.9662l0,-7.86508c0,-1.08594 -0.8803,-1.96626 -1.9663,-1.96626l-7.86501,0z" fill-rule="evenodd"/><path d="m5.09049,10.18526l-1.82767,-1.82766l-0.78479,0.78479l2.61246,2.61246l5.38758,-5.38754l-0.78483,-0.78479l-4.60275,4.60274z"/></svg></span><span>Empty</span></span></div>
                        ]]>
    </checklist>


                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                <customfield id="customfield_10111" key="com.atlassian.jira.toolkit:reporterdomain">
                        <customfieldname>Company</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>magnolia-cms.com</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_10031" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of First Response</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Thu, 1 Dec 2016 13:37:10 +0100</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_12730" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_14151" key="com.atlassian.jira.toolkit:message">
                        <customfieldname>Docu info</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_10061" key="com.atlassian.jira.toolkit:lastusercommented">
                        <customfieldname>Last comm is not jira-dev</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>true</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10071" key="com.atlassian.jira.toolkit:lastupdaterorcommenter">
                        <customfieldname>Last participant</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>rgange</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_13136" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            4 years, 15 weeks, 4 days ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10020" key="com.atlassian.jira.toolkit:attachments">
                        <customfieldname>Number of attachments</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10150" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname>Number of comments</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>5.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10011" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>ahietala</customfieldvalue>
            <customfieldvalue>creichenbach</customfieldvalue>
            <customfieldvalue>czimmermann</customfieldvalue>
            <customfieldvalue>cmeier</customfieldvalue>
            <customfieldvalue>rgange</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                <customfield id="customfield_10833" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0|hzzzk5:zxz</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10244" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>9223372036854775807</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_14145" key="com.intenso.jira.issue-templates:issue-templates-customfield">
                        <customfieldname>Template</customfieldname>
                        <customfieldvalues>
                            


                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_15131" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname>Time in Discovery</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10032" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>Time in Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        </customfields>
    </item>
</channel>
</rss>