<!-- 
RSS generated by JIRA (9.4.2#940002-sha1:46d1a51de284217efdcb32434eab47a99af2938b) at Sun Feb 11 23:39:43 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>[BUILD-200] Introduce asciidoc for Javadoc</title>
                <link>https://jira.magnolia-cms.com/browse/BUILD-200</link>
                <project id="10330" key="BUILD">Build</project>
                    <description>&lt;p&gt;See&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;&lt;a href=&quot;https://github.com/asciidoctor/asciidoclet&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/asciidoctor/asciidoclet&lt;/a&gt;&lt;/li&gt;
	&lt;li&gt;&lt;a href=&quot;http://asciidoctor.org/news/2013/06/03/asciidoclet-announcement/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://asciidoctor.org/news/2013/06/03/asciidoclet-announcement/&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;This is also related to &lt;a href=&quot;https://jira.magnolia-cms.com/browse/BUILD-195&quot; title=&quot;Disable doclint for javadoc (Cannot build javadoc of main on java 8)&quot; class=&quot;issue-link&quot; data-issue-key=&quot;BUILD-195&quot;&gt;&lt;del&gt;BUILD-195&lt;/del&gt;&lt;/a&gt;; if we do this and/or disable doclint for javadoc, we need to decide if/how we migrate existing javadoc that uses html.&lt;/p&gt;</description>
                <environment></environment>
        <key id="43722">BUILD-200</key>
            <summary>Introduce asciidoc for Javadoc</summary>
                <type id="2" iconUrl="https://jira.magnolia-cms.com/secure/viewavatar?size=xsmall&amp;avatarId=10891&amp;avatarType=issuetype">New Feature</type>
                                            <priority id="3" iconUrl="https://jira.magnolia-cms.com/images/icons/priorities/major.svg">Major</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="1">Fixed</resolution>
                                        <assignee username="gjoseph">Magnolia International</assignee>
                                    <reporter username="gjoseph">Magnolia International</reporter>
                        <labels>
                    </labels>
                <created>Mon, 16 Mar 2015 11:44:49 +0100</created>
                <updated>Thu, 7 Jul 2016 11:37:41 +0200</updated>
                            <resolved>Mon, 4 May 2015 12:43:41 +0200</resolved>
                                                    <fixVersion>POMs 31</fixVersion>
                                        <due></due>
                            <votes>0</votes>
                                    <watches>1</watches>
                                                                                                                <comments>
                            <comment id="100470" author="gjoseph" created="Mon, 16 Mar 2015 18:10:55 +0100"  >&lt;p&gt;This works neatly, but unfortunately is not lenient towards existing html-based javadocs.&lt;br/&gt;
I raised an issue with the Asciidoctor people, let&apos;s see what happens: &lt;a href=&quot;https://github.com/asciidoctor/asciidoclet/issues/40&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/asciidoctor/asciidoclet/issues/40&lt;/a&gt;&lt;br/&gt;
(we can either mass-convert our existing docs if we find an appropriate tool (which would need to be javadoc aware .. yikes), or provide a fix for the issue in question, if detecting the presence of html in a javadoc comment is safe enough (i.e I doubt it is completely safe, since one might in fact HAVE html in their Asciidoc, e.g code samples)&lt;/p&gt;</comment>
                            <comment id="100499" author="gjoseph" created="Tue, 17 Mar 2015 11:48:27 +0100"  >&lt;p&gt;Suggestions by johncarl81 are very good. I&apos;m thinking:&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;a flag on a per-project basis to enable the doclet&lt;/li&gt;
	&lt;li&gt;a script to mass-convert existing javadoc for those projects.&lt;/li&gt;
&lt;/ul&gt;
</comment>
                            <comment id="100510" author="gjoseph" created="Tue, 17 Mar 2015 12:55:11 +0100"  >&lt;p&gt;This script can be used, e.g:&lt;br/&gt;
&lt;tt&gt;groovy ConvertJavadocToAsciiDoc.groovy ~/Dev/magnolia/git/magnolia_main/magnolia-core&lt;/tt&gt;&lt;/p&gt;</comment>
                            <comment id="100556" author="gjoseph" created="Tue, 17 Mar 2015 18:53:56 +0100"  >&lt;p&gt;And we could apply this patch to enable projects to opt-out (I&apos;d rather opt-in, but once more Maven&apos;s lack of the simplest boolean logic in properties doesn&apos;t make it possible)&lt;/p&gt;
&lt;div class=&quot;preformatted panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;preformattedContent panelContent&quot;&gt;
&lt;pre&gt;diff --git a/poms/super-pom/pom.xml b/poms/super-pom/pom.xml
index 5f79dca..fb0a5b8 100644
--- a/poms/super-pom/pom.xml
+++ b/poms/super-pom/pom.xml
@@ -57,6 +57,8 @@
          to reconfigure said plugins.
      --&amp;gt;
     &amp;lt;skipTestJar&amp;gt;true&amp;lt;/skipTestJar&amp;gt;
+    &amp;lt;!-- Set to empty to use the standard Javadoc Doclet --&amp;gt;
+    &amp;lt;javadocDocletClass&amp;gt;org.asciidoctor.Asciidoclet&amp;lt;/javadocDocletClass&amp;gt;
   &amp;lt;/properties&amp;gt;
 
   &amp;lt;build&amp;gt;
@@ -144,6 +146,12 @@
           &amp;lt;configuration&amp;gt;
             &amp;lt;detectOfflineLinks&amp;gt;false&amp;lt;/detectOfflineLinks&amp;gt;
             &amp;lt;detectLinks&amp;gt;false&amp;lt;/detectLinks&amp;gt;
+            &amp;lt;doclet&amp;gt;${javadocDocletClass}&amp;lt;/doclet&amp;gt;
+            &amp;lt;docletArtifact&amp;gt;
+              &amp;lt;groupId&amp;gt;org.asciidoctor&amp;lt;/groupId&amp;gt;
+              &amp;lt;artifactId&amp;gt;asciidoclet&amp;lt;/artifactId&amp;gt;
+              &amp;lt;version&amp;gt;1.5.2&amp;lt;/version&amp;gt;
+            &amp;lt;/docletArtifact&amp;gt;
           &amp;lt;/configuration&amp;gt;
         &amp;lt;/plugin&amp;gt;
         &amp;lt;plugin&amp;gt;
&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;</comment>
                            <comment id="100636" author="gjoseph" created="Wed, 18 Mar 2015 16:25:32 +0100"  >&lt;p&gt;Needs validation - do we all want this ?&lt;/p&gt;</comment>
                            <comment id="100638" author="gjoseph" created="Wed, 18 Mar 2015 16:42:02 +0100"  >&lt;p&gt;Alternative proposal: in projects, pick which one you want:&lt;/p&gt;
&lt;div class=&quot;code panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;codeContent panelContent&quot;&gt;
&lt;pre class=&quot;code-java&quot;&gt;
  &amp;lt;properties&amp;gt;
    &amp;lt;javadocDoclet&amp;gt;${standardDoclet}&amp;lt;/javadocDoclet&amp;gt;
  &amp;lt;/properties&amp;gt;
&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;p&gt;or&lt;/p&gt;
&lt;div class=&quot;code panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;codeContent panelContent&quot;&gt;
&lt;pre class=&quot;code-java&quot;&gt;
  &amp;lt;properties&amp;gt;
    &amp;lt;javadocDoclet&amp;gt;${asciidocDoclet}&amp;lt;/javadocDoclet&amp;gt;
  &amp;lt;/properties&amp;gt;
&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;</comment>
                            <comment id="103220" author="gjoseph" created="Mon, 4 May 2015 12:43:41 +0200"  >&lt;p&gt;Default is kept to standard doclet. Projects can explicitely use either:&lt;/p&gt;
&lt;div class=&quot;code panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;codeContent panelContent&quot;&gt;
&lt;pre class=&quot;code-java&quot;&gt;
  &amp;lt;properties&amp;gt;
    &amp;lt;javadocDoclet&amp;gt;${standardDoclet}&amp;lt;/javadocDoclet&amp;gt;
  &amp;lt;/properties&amp;gt;
&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;p&gt;or&lt;/p&gt;
&lt;div class=&quot;code panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;codeContent panelContent&quot;&gt;
&lt;pre class=&quot;code-java&quot;&gt;
  &amp;lt;properties&amp;gt;
    &amp;lt;javadocDoclet&amp;gt;${asciidocDoclet}&amp;lt;/javadocDoclet&amp;gt;
  &amp;lt;/properties&amp;gt;
&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10040">
                    <name>causality</name>
                                                                <inwardlinks description="is causing">
                                        <issuelink>
            <issuekey id="53594">BUILD-238</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </issuelinktype>
                            <issuelinktype id="10010">
                    <name>relation</name>
                                                                <inwardlinks description="is related to">
                                        <issuelink>
            <issuekey id="22164">BUILD-79</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="44784">BUILD-209</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="43662">BUILD-195</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </issuelinktype>
                    </issuelinks>
                <attachments>
                            <attachment id="27523" name="ConvertJavadocToAsciiDoc.groovy" size="1030" author="gjoseph" created="Tue, 17 Mar 2015 12:55:11 +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_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>mgeljic</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_13136" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            8 years, 41 weeks, 6 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>7.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10011" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>gjoseph</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                <customfield id="customfield_10833" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0|i04rzr:</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>