<!-- 
RSS generated by JIRA (1001.0.0-SNAPSHOT#100246-sha1:7a5c50119eb0633d306e14180817ddef5e80c75d) at Thu Feb 08 23:05:28 UTC 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 add field=key&field=summary to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>FOLIO Jira</title>
    <link>https://folio-org.atlassian.net</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>1001.0.0-SNAPSHOT</version>
        <build-number>100246</build-number>
        <build-date>07-02-2024</build-date>
    </build-info>

<item>
            <title>[FOLIO-397] Document how to update git submodules</title>
                <link>https://folio-org.atlassian.net/browse/FOLIO-397</link>
                <project id="10290" key="FOLIO">FOLIO</project>
                    <description>&lt;p&gt;Some FOLIO repositories utilize &quot;git submodules&quot; for sections of common code. Need to explain how to update such.&lt;/p&gt;

&lt;p&gt;For example (with DMOD-75) each mod-* module and ram-module-builder include the &quot;raml&quot; repository as a git submodule as its &quot;./raml-util&quot; directory.&lt;/p&gt;</description>
                <environment></environment>
        <key id="80097">FOLIO-397</key>
            <summary>Document how to update git submodules</summary>
                <type id="10003" iconUrl="https://folio-org.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10318?size=medium">Task</type>
                                            <priority id="10002" iconUrl="https://dev.folio.org/assets/jira-priority/jira-p3.svg">P3</priority>
                        <status id="6" iconUrl="https://folio-org.atlassian.net/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="green"/>
                                    <resolution id="10003">Done</resolution>
                                                        <assignee accountid="61cd0ca0bce5e00069e98be7">David Crossley</assignee>
                                                                <reporter accountid="61cd0ca0bce5e00069e98be7">David Crossley</reporter>
                                    <labels>
                    </labels>
                <created>Wed, 30 Nov 2016 03:52:52 +0000</created>
                <updated>Mon, 12 Nov 2018 14:23:20 +0000</updated>
                            <resolved>Tue, 6 Dec 2016 04:59:38 +0000</resolved>
                                                                        <due></due>
                            <votes>0</votes>
                                    <watches>1</watches>
                                                    <timespent seconds="23100">6 hours, 25 minutes</timespent>
                                <comments>
                                                            <comment id="188299" author="61cd0ca0bce5e00069e98be7" created="Wed, 30 Nov 2016 04:12:17 +0000"  >&lt;p&gt;Note that when originally cloning a repository, use &apos;git clone --recursive ...&apos;&lt;br/&gt;
Some git clients do not. If you then have an empty &quot;raml-util&quot; directory, then do &apos;git submodule update --init&apos;.&lt;/p&gt;</comment>
                                                            <comment id="188300" author="61cd0ca0bce5e00069e98be7" created="Wed, 30 Nov 2016 05:07:15 +0000"  >&lt;p&gt;Thereafter updating that submodule is deliberately not automated, so that we can ensure a stable build when we git checkout in the future.&lt;/p&gt;

&lt;p&gt;So when an update is needed to be committed, do this:&lt;/p&gt;

&lt;p&gt;cd mod-configuration (for example)&lt;br/&gt;
git submodule foreach &apos;git checkout master &amp;amp;&amp;amp; git pull origin master&apos;&lt;br/&gt;
git commit ...&lt;/p&gt;</comment>
                                                            <comment id="188302" author="61cd0ca0bce5e00069e98be7" created="Wed, 30 Nov 2016 05:41:43 +0000"  >&lt;p&gt;Now when people update their local checkout, then some git clients do not automatically update the submodules. So they need to follow with &apos;git submodule update&apos;&lt;/p&gt;

&lt;p&gt;This part can be automated with client-side git hooks.&lt;/p&gt;

&lt;p&gt;Create the following two shell scripts:&lt;/p&gt;

&lt;p&gt;mod-configuration/.git/hooks/post-checkout&lt;br/&gt;
mod-configuration/.git/hooks/post-merge&lt;/p&gt;

&lt;p&gt;using this content:&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;#!/bin/sh
git submodule update
&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;

&lt;p&gt;and make them executable: &apos;chmod +x post-checkout post-merge&apos;&lt;/p&gt;

&lt;p&gt;Now subsequent updates will also update the submodules to their declared revision.&lt;/p&gt;</comment>
                                                            <comment id="188304" author="61cd0ca0bce5e00069e98be7" created="Wed, 30 Nov 2016 05:43:28 +0000"  >&lt;p&gt;Need to add such documentation at dev.folio.org/doc/setup (
    &lt;span class=&quot;jira-issue-macro&quot; data-jira-key=&quot;FOLIO-366&quot; &gt;
                &lt;a href=&quot;https://folio-org.atlassian.net/browse/FOLIO-366&quot; class=&quot;jira-issue-macro-key issue-link&quot;  title=&quot;Commence a new document to assist with developer setup&quot; &gt;
            &lt;img class=&quot;icon&quot; src=&quot;https://folio-org.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10322?size=medium&quot; /&gt;
            FOLIO-366
        &lt;/a&gt;
                                                    &lt;span class=&quot;aui-lozenge aui-lozenge-subtle aui-lozenge-current jira-macro-single-issue-export-pdf&quot;&gt;In Progress&lt;/span&gt;
            &lt;/span&gt;
)&lt;/p&gt;</comment>
                                                            <comment id="188305" author="61cd0ca0bce5e00069e98be7" created="Thu, 1 Dec 2016 01:08:06 +0000"  >&lt;p&gt;See the Discuss topic:&lt;br/&gt;
&lt;a href=&quot;https://discuss.folio.org/t/now-using-git-submodules-for-common-set-of-raml-files/417&quot; class=&quot;external-link&quot; rel=&quot;nofollow noreferrer&quot;&gt;https://discuss.folio.org/t/now-using-git-submodules-for-common-set-of-raml-files/417&lt;/a&gt;&lt;/p&gt;</comment>
                                                            <comment id="188307" author="61cd0ca0bce5e00069e98be7" created="Tue, 6 Dec 2016 04:59:38 +0000"  >&lt;p&gt;Added to &lt;a href=&quot;http://dev.folio.org/doc/setup#update-git-submodules&quot; class=&quot;external-link&quot; rel=&quot;nofollow noreferrer&quot;&gt;http://dev.folio.org/doc/setup#update-git-submodules&lt;/a&gt;&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10003">
                    <name>Relates</name>
                                            <outwardlinks description="relates to">
                                        <issuelink>
            <issuekey id="79850">FOLIO-366</issuekey>
        </issuelink>
                            </outwardlinks>
                                                        </issuelinktype>
                    </issuelinks>
                <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                <customfield id="customfield_10000" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummarycf">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10019" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0|hzxi6n:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10020" key="com.pyxis.greenhopper.jira:gh-sprint">
                        <customfieldname>Sprint</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10025" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>[CHART] Time in Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                    </customfields>
    </item>
</channel>
</rss>