<!-- 
RSS generated by JIRA (9.4.2#940002-sha1:46d1a51de284217efdcb32434eab47a99af2938b) at Mon Feb 12 01:06:20 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-143] Screenshots in dev environment instructions</title>
                <link>https://jira.magnolia-cms.com/browse/DOCU-143</link>
                <project id="10190" key="DOCU">Documentation</project>
                    <description>&lt;p&gt;The screenshots in development environment setup instructions still look awful. Tops are cut off and there is unrelated stuff at the bottom and sides. In some images it&apos;s unclear what is being illustrated and some are just not necessary for a competent person who is about to develop code.&lt;/p&gt;

&lt;ul&gt;
	&lt;li&gt;Take new screenshots. Follow &lt;a href=&quot;http://wiki.magnolia-cms.com/display/DOCU/Documentation+Style+Guide#DocumentationStyleGuide-Imagesandscreenshots&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Documentation Style Guide&lt;/a&gt;&lt;/li&gt;
	&lt;li&gt;When shooting an OS dialog, capture the whole dialog. Don&apos;t cut off at the top. Don&apos;t leave extra stuff on the sides and bottom. See borders.png attached.&lt;/li&gt;
	&lt;li&gt;When it&apos;s unclear what the reader should be doing in the screenshot, use annotations and illustration. Use clean-looking arrows and circles that are hand-drawn style. Get an application that can do these. It should be part of a technical writer&apos;s toolset. See annotate.png attached. Use Magnolia corporate color scheme.&lt;/li&gt;
	&lt;li&gt;When shooting a part of a page, leave some white space around the element. See e.g. &lt;a href=&quot;http://documentation.magnolia-cms.com/modules/form.html#Fieldsets&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Field sets&lt;/a&gt;&lt;/li&gt;
	&lt;li&gt;Store at full resolution. Don&apos;t zoom out. Images get fuzzy. Bad example: &lt;a href=&quot;http://documentation.magnolia-cms.com/dms/developing/dev-environment/tomcat/starting-tomcat.PNG&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;starting-tomcat.png&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;

</description>
                <environment></environment>
        <key id="20427">DOCU-143</key>
            <summary>Screenshots in dev environment instructions</summary>
                <type id="3" iconUrl="https://jira.magnolia-cms.com/secure/viewavatar?size=xsmall&amp;avatarId=10898&amp;avatarType=issuetype">Task</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="1">Fixed</resolution>
                                        <assignee username="sdeprez">Suzanne Deprez</assignee>
                                    <reporter username="ahietala">Antti Hietala</reporter>
                        <labels>
                    </labels>
                <created>Fri, 15 Apr 2011 15:42:54 +0200</created>
                <updated>Fri, 27 May 2011 17:28:59 +0200</updated>
                            <resolved>Fri, 27 May 2011 15:31:38 +0200</resolved>
                                                                    <component>content</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>0</watches>
                                                                                                                <comments>
                            <comment id="34898" author="sdeprez" created="Mon, 18 Apr 2011 21:54:02 +0200"  >&lt;p&gt;Dialogs were taken with Windows Snipping Tool full window snip.  The cut off at the top is being done by that tool.&lt;/p&gt;

&lt;p&gt;The window in borders.png has borders.  No borders were added to images.  Can start cropping windows that have borders.&lt;/p&gt;

&lt;p&gt;With respect to maven-download-fuzzy.png, upper/left portion of screen was retained so reader could recognize they were on the correct page while executing the procedure.  Since the download links also needed to be included, this resulted in an image with a width of more than 600 px. Image was reduced until width was 600 px or less.&lt;/p&gt;

&lt;p&gt;With respect to start-tomcat.png, I wanted to leave the Command Prompt windows large enough so the reader could see enough to tell what was happening which resulted in windows wider than 600 px.&lt;/p&gt;

&lt;p&gt;Sent E-mail with proposals for proceeding with redoing images.&lt;/p&gt;</comment>
                            <comment id="35044" author="sdeprez" created="Fri, 22 Apr 2011 17:22:15 +0200"  >&lt;p&gt;Activated image and page changes.&lt;/p&gt;</comment>
                            <comment id="35189" author="ahietala" created="Mon, 2 May 2011 09:00:26 +0200"  >&lt;p&gt;Thanks. Nearly there. Please revise the following screenshots:&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;environment-variables.png in &lt;a href=&quot;http://documentation.magnolia-cms.com/developing/dev-environment/maven/maven-env-var.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Maven environment variables&lt;/a&gt;. Top of dialog is cut off.&lt;/li&gt;
	&lt;li&gt;start-creating-settings-xml.png in &lt;a href=&quot;http://documentation.magnolia-cms.com/developing/dev-environment/maven/maven-init.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Initialize Maven&lt;/a&gt;. Fuzzy. Redo as code block.&lt;/li&gt;
	&lt;li&gt;select-workspace.png in &lt;a href=&quot;http://documentation.magnolia-cms.com/developing/dev-environment/eclipse.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Eclipse&lt;/a&gt; and in &lt;a href=&quot;http://documentation.magnolia-cms.com/developing/dev-environment/retrieve-code.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Retrieve code from SVN&lt;/a&gt;. Fuzzy. Is the dialog resizable? Can you make it narrower so no zooming is necessary?&lt;/li&gt;
	&lt;li&gt;select-m2-extras-download-site.png and select-wtp-plugin.png in &lt;a href=&quot;http://documentation.magnolia-cms.com/developing/dev-environment/eclipse/wtp-plugin.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;WTP plugin&lt;/a&gt;. Fuzzy. Similar screenshots in &lt;a href=&quot;http://documentation.magnolia-cms.com/developing/dev-environment/eclipse/maven-plugin.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Maven plugin&lt;/a&gt; page are sharp and crisp.&lt;/li&gt;
	&lt;li&gt;enter-svn-custom-label.png in &lt;a href=&quot;http://documentation.magnolia-cms.com/developing/dev-environment/retrieve-code.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Retrieve code from SVN&lt;/a&gt;. Fuzzy.&lt;/li&gt;
	&lt;li&gt;set-tomcat-params.png in &lt;a href=&quot;http://documentation.magnolia-cms.com/developing/dev-environment/add-server.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Add Tomcat server in Eclipse&lt;/a&gt;. Hard to read. Screenshot necessary?&lt;/li&gt;
	&lt;li&gt;start-magnolia-empty-webapp-in-browser.png in &lt;a href=&quot;http://documentation.magnolia-cms.com/developing/dev-environment/run-code.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Run code in Eclipse&lt;/a&gt;. Use a minimal browser when taking full browser screenshots. No bookmarks toolbar.&lt;/li&gt;
&lt;/ul&gt;
</comment>
                            <comment id="35806" author="sdeprez" created="Wed, 25 May 2011 19:06:33 +0200"  >&lt;p&gt;The content of start-creating-settings.xml is in the previous steps.  This image is meant to be an illustration of entering the steps to emphasize they must be entered within the user&apos;s home directory.  The image was redone with a smaller window.&lt;/p&gt;

&lt;p&gt;The window in select-workspace.png can&apos;t be resized.&lt;/p&gt;

&lt;p&gt;Split set-tomcat-params.png into 2 images.  Need to show where entries are in screen, hard to see at first.&lt;/p&gt;

&lt;p&gt;Activated changes.&lt;/p&gt;</comment>
                            <comment id="35932" author="ahietala" created="Fri, 27 May 2011 15:28:46 +0200"  >&lt;blockquote&gt;&lt;p&gt;The window in select-workspace.png can&apos;t be resized.&lt;/p&gt;&lt;/blockquote&gt;
&lt;p&gt;Then use full size.&lt;/p&gt;

&lt;p&gt;Published other changes.&lt;/p&gt;</comment>
                            <comment id="35935" author="sdeprez" created="Fri, 27 May 2011 17:28:59 +0200"  >&lt;p&gt;Uploaded and activated full size for select-workspace.png.&lt;/p&gt;</comment>
                    </comments>
                    <attachments>
                            <attachment id="14516" name="annotate.png" size="76040" author="ahietala" created="Fri, 15 Apr 2011 15:42:54 +0200"/>
                            <attachment id="14515" name="borders.png" size="100743" author="ahietala" created="Fri, 15 Apr 2011 15:42:54 +0200"/>
                            <attachment id="14517" name="maven-download-fuzzy.png" size="199554" author="ahietala" created="Fri, 15 Apr 2011 15:42:54 +0200"/>
                    </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>Mon, 18 Apr 2011 21:54:02 +0200</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>
                            12 years, 39 weeks, 2 days ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10020" key="com.atlassian.jira.toolkit:attachments">
                        <customfieldname>Number of attachments</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>3.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10150" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname>Number of comments</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>6.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10011" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>ahietala</customfieldvalue>
            <customfieldvalue>sdeprez</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                <customfield id="customfield_10833" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0|i040nr:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10244" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>23549</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                <customfield id="customfield_14167" key="com.okapya.jira.checklist:checklist">
                        <customfieldname>Task DoR</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_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>