<!-- 
RSS generated by JIRA (9.4.2#940002-sha1:46d1a51de284217efdcb32434eab47a99af2938b) at Mon Feb 12 01:05:31 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-57] Documentation severely lacking in several areas</title>
                <link>https://jira.magnolia-cms.com/browse/DOCU-57</link>
                <project id="10190" key="DOCU">Documentation</project>
                    <description>&lt;p&gt;I signed up yesterday for the 60 day EE trial after seeing this on the Magnolia website:&lt;/p&gt;

&lt;p&gt;&quot;Customers of Magnolia Enterprise Edition receive additional documentation upon purchase. The documentation for Magnolia Enterprise Edition includes detailed information on all added functionality.&lt;/p&gt;

&lt;p&gt;Please contact us for further information&quot;&lt;br/&gt;
(source: &lt;a href=&quot;http://www.magnolia.info/home/community/documentation.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://www.magnolia.info/home/community/documentation.html&lt;/a&gt; )&lt;/p&gt;

&lt;p&gt;So I clicked the link and asked for the documentation.  Here was the response I received back:&lt;/p&gt;

&lt;p&gt;&quot;As we cannot find you in our POC records, may I ask why you are asking?  Regards, Boris &lt;span class=&quot;error&quot;&gt;&amp;#91;Kraft, CEO, Co-Founder, Magnolia Americas, Inc.&amp;#93;&lt;/span&gt;&quot;&lt;/p&gt;

&lt;p&gt;I responded back:&lt;/p&gt;

&lt;p&gt;&quot;I just signed up for your 60-day trial yesterday and I&apos;m finding the online documentation and mailing lists severely lacking. I&apos;m hoping this &apos;additional documentation&apos; will help answer my  questions.&quot;&lt;/p&gt;

&lt;p&gt;Boris&apos;s response:&lt;/p&gt;

&lt;p&gt;&quot;Please be so kind and add in the most specific way possible what you are missing as a task to jira, so that we can update our documentation accordingly. We have seen many successful projects and happy clients with less than the existing documentation, but people have different expectations, and we are working on meeting them.&quot;&lt;/p&gt;

&lt;p&gt;Alright Boris, here&apos;s the constructive criticism that you&apos;re seeking:&lt;/p&gt;

&lt;p&gt;I am currently evaluating open-source JCR-based CMS solutions.  I need to know if a CMS package does the following:&lt;/p&gt;

&lt;ul&gt;
	&lt;li&gt;Does it store the following:&lt;br/&gt;
          o  XML (including metadata extraction upon check-in and searching of that XML metadata)&lt;br/&gt;
          o Binary Files&lt;/li&gt;
	&lt;li&gt;Does it permit versioning, and if so, how does it work?&lt;/li&gt;
	&lt;li&gt;Does it offer multiple &quot;spaces&quot;?&lt;/li&gt;
	&lt;li&gt;How do the User and Group Permissions work?  What types of authentication servers can it use?  Can it differentiate within a single group between those users who have read-write privileges and those users who have read-only privileges?&lt;/li&gt;
	&lt;li&gt;Does it permit easy purging of &quot;expired&quot; files - preferably via automatic means?&lt;/li&gt;
	&lt;li&gt;What types of replication / clustering does it permit?&lt;/li&gt;
	&lt;li&gt;What are the backend database choices?&lt;/li&gt;
	&lt;li&gt;How does it do a consistency check between the database and the files to make sure (a) orphaned files do not occur, and (b) files are not deleted without updating the database?&lt;/li&gt;
	&lt;li&gt;Is there a web service option?  What is the web service API?  Is there sample Java code using this web service API?&lt;/li&gt;
	&lt;li&gt;Is there a Java API for an embedded server?  Is there sample Java code using this embedded server?&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;The first CMS I looked at was Alfresco.  Alfresco has VOLUMINOUS documentation - so much so that it&apos;s very difficult to browse.  But  if I google the various topics I listed above, I quickly found what I needed.&lt;/p&gt;

&lt;p&gt;Magnolia was the second CMS at which I looked.  You folks need far more documentation. As an example, regarding my question of versioning, Google searches failed, so I had to hunt in the user-list to find the following stashed in the middle of threads (and it took me a while to find the message that described how to enable it in the documents section):&lt;/p&gt;

&lt;ul&gt;
	&lt;li&gt;here&apos;s how to enable it for the Documents section: &lt;a href=&quot;http://www.nabble.com/Re%3A-DMS-%22Upload-new-version%22---where-is-the-version--p18708676.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://www.nabble.com/Re%3A-DMS-%22Upload-new-version%22---where-is-the-version--p18708676.html&lt;/a&gt;&lt;/li&gt;
	&lt;li&gt;Here&apos;s how to enable it for the webpages: &lt;a href=&quot;http://www.nabble.com/Re%3A-Versioning-not-working-p16858909.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://www.nabble.com/Re%3A-Versioning-not-working-p16858909.html&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;



&lt;p&gt;Compare that with Alfresco - this information was at the top of Google searches for &quot;Alfresco versioning&quot;:&lt;/p&gt;

&lt;ul&gt;
	&lt;li&gt;Alfresco will do this: &lt;a href=&quot;http://wiki.alfresco.com/wiki/Versioned_Directories&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://wiki.alfresco.com/wiki/Versioned_Directories&lt;/a&gt; and &lt;a href=&quot;http://wiki.alfresco.com/wiki/Versioning_Behaviour&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://wiki.alfresco.com/wiki/Versioning_Behaviour&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;Do you see the difference?&lt;/p&gt;

&lt;p&gt;I still have three open queries in the user-list:&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;http://www.nabble.com/Replication---clustering-td19080762.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://www.nabble.com/Replication---clustering-td19080762.html&lt;/a&gt;&lt;br/&gt;
&lt;a href=&quot;http://www.nabble.com/XML-Metadata-Extraction-for-searching--td19080480.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://www.nabble.com/XML-Metadata-Extraction-for-searching--td19080480.html&lt;/a&gt;&lt;br/&gt;
&lt;a href=&quot;http://www.nabble.com/Can-one-set-Magnolia-to-expire-files-automatically-after-a-specified-time-period--td19080532.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://www.nabble.com/Can-one-set-Magnolia-to-expire-files-automatically-after-a-specified-time-period--td19080532.html&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;The answer I received on that last query is not what I wanted to hear.  Automated expiration of documents should be a standard feature, not something I need to write and debug myself.&lt;/p&gt;

&lt;p&gt;Alfresco appears to meet our needs right now, especially in the documentation department.  With Magnolia, I&apos;d have a lot more work to do to get it in shape, praying to G-d that I found the bugs in my code before we went live.  I hope this will help y&apos;all get a better picture of what your users need.&lt;/p&gt;</description>
                <environment></environment>
        <key id="15074">DOCU-57</key>
            <summary>Documentation severely lacking in several areas</summary>
                <type id="4" iconUrl="https://jira.magnolia-cms.com/secure/viewavatar?size=xsmall&amp;avatarId=10890&amp;avatarType=issuetype">Improvement</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="8">Outdated</resolution>
                                        <assignee username="gjoseph">Magnolia International</assignee>
                                    <reporter username="philip.schlesinger">Philip Schlesinger</reporter>
                        <labels>
                    </labels>
                <created>Thu, 21 Aug 2008 20:59:09 +0200</created>
                <updated>Tue, 22 Sep 2015 14:05:53 +0200</updated>
                            <resolved>Tue, 22 Sep 2015 14:05:53 +0200</resolved>
                                                                        <due></due>
                            <votes>0</votes>
                                    <watches>1</watches>
                                                                                                                <comments>
                            <comment id="31919" author="ahietala" created="Mon, 13 Dec 2010 14:24:48 +0100"  >&lt;p&gt;Most of the questions are now answered in the Technical Guide or elsewhere on the Documentation site. There are still topics that need documentation such as authentication server options and dependency management.&lt;/p&gt;</comment>
                            <comment id="113041" author="cmeier" created="Tue, 22 Sep 2015 14:05:53 +0200"  >&lt;p&gt;This ticket very old and the &quot;issue&quot; is much too much too general.&lt;/p&gt;</comment>
                    </comments>
                    <attachments>
                    </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>farheap.com</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_10031" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of First Response</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Mon, 13 Dec 2010 14:24:48 +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>mmuehlebach</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_13136" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            8 years, 21 weeks, 5 days ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10020" key="com.atlassian.jira.toolkit:attachments">
                        <customfieldname>Number of attachments</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10150" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname>Number of comments</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10011" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>ahietala</customfieldvalue>
            <customfieldvalue>cmeier</customfieldvalue>
            <customfieldvalue>gjoseph</customfieldvalue>
            <customfieldvalue>philip.schlesinger</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                <customfield id="customfield_10833" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0|i048d3:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10244" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>24797</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>