<!-- 
RSS generated by JIRA (1001.0.0-SNAPSHOT#100246-sha1:7a5c50119eb0633d306e14180817ddef5e80c75d) at Thu Feb 08 23:10:23 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-1040] Tidy and clarify shared raml-util and each raml-using repo</title>
                <link>https://folio-org.atlassian.net/browse/FOLIO-1040</link>
                <project id="10290" key="FOLIO">FOLIO</project>
                    <description>&lt;p&gt;Tidy the &quot;raml&quot; repository (i.e. the shared raml-util) and each repository using it to ensure consistency.&lt;/p&gt;

&lt;p&gt;(This issue started as &quot;Split shared raml into separate components&quot; and was later repurposed.)&lt;/p&gt;</description>
                <environment></environment>
        <key id="80533">FOLIO-1040</key>
            <summary>Tidy and clarify shared raml-util and each raml-using repo</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="5f8314dfbdef80006f6f572d">Adam Dickmeiss</reporter>
                                    <labels>
                            <label>ci</label>
                            <label>core</label>
                            <label>madrid</label>
                            <label>sprint31</label>
                            <label>sprint32</label>
                            <label>sprint33</label>
                    </labels>
                <created>Mon, 29 Jan 2018 12:18:57 +0000</created>
                <updated>Mon, 12 Nov 2018 14:24:04 +0000</updated>
                            <resolved>Fri, 7 Sep 2018 07:39:31 +0000</resolved>
                                                                        <due></due>
                            <votes>0</votes>
                                    <watches>4</watches>
                                                    <timespent seconds="213300">1 week, 2 days, 3 hours, 15 minutes</timespent>
                                <comments>
                                                            <comment id="189529" author="557058:b8e64633-1f7c-402d-9caf-9959a5ba5d0d" created="Wed, 7 Feb 2018 14:15:06 +0000"  >&lt;p&gt;we have decided not to do this but instead David Crossley will clean up the raml repo and other repos to make sure we don&apos;t have any duplicates and it&apos;s clear where the schemas are maintained.&lt;/p&gt;
</comment>
                                                            <comment id="189530" author="61cd0ca0bce5e00069e98be7" created="Tue, 20 Feb 2018 13:16:45 +0000"  >&lt;p&gt;Some raml-util are out-of-date. See listing attached compare-raml-util-2018022023.txt&lt;/p&gt;

&lt;p&gt;Many may not need the most recent, but it would be better to be as recent as possible. Then also easier to update raml-util with more confidence.&lt;/p&gt;

&lt;p&gt;Some recent updates were:&lt;br/&gt;
2018-01-16 : schemas/mod-users/userdata.json : Update userdata with metadata object. Require addressType field for addresstypes&lt;br/&gt;
2018-01-13 : schemas/resultInfo.schema : Add further diagnostics 
    &lt;span class=&quot;jira-issue-macro resolved&quot; data-jira-key=&quot;MODCXMUX-14&quot; &gt;
                &lt;a href=&quot;https://folio-org.atlassian.net/browse/MODCXMUX-14&quot; class=&quot;jira-issue-macro-key issue-link&quot;  title=&quot;Per-source record-counts, rewritten query&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;
            MODCXMUX-14
        &lt;/a&gt;
                                                    &lt;span class=&quot;aui-lozenge aui-lozenge-subtle aui-lozenge-success jira-macro-single-issue-export-pdf&quot;&gt;Closed&lt;/span&gt;
            &lt;/span&gt;
&lt;br/&gt;
2017-12-08 : raml/schemas/metadata.schema : Fix the UUID pattern 
    &lt;span class=&quot;jira-issue-macro resolved&quot; data-jira-key=&quot;FOLIO-972&quot; &gt;
                &lt;a href=&quot;https://folio-org.atlassian.net/browse/FOLIO-972&quot; class=&quot;jira-issue-macro-key issue-link&quot;  title=&quot;The regex pattern for UUID in schemas does not completely allow mixed-case characters&quot; &gt;
            &lt;img class=&quot;icon&quot; src=&quot;https://folio-org.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10303?size=medium&quot; /&gt;
            FOLIO-972
        &lt;/a&gt;
                                                    &lt;span class=&quot;aui-lozenge aui-lozenge-subtle aui-lozenge-success jira-macro-single-issue-export-pdf&quot;&gt;Closed&lt;/span&gt;
            &lt;/span&gt;
&lt;/p&gt;</comment>
                                                            <comment id="189532" author="61cd0ca0bce5e00069e98be7" created="Tue, 20 Feb 2018 13:18:39 +0000"  >&lt;p&gt;Old duplicate copies of raml-util in mod-login mod-users mod-users-bl&lt;/p&gt;

&lt;p&gt;mod-users-bl/raml would be better called &quot;raml-util&quot; like the rest.&lt;/p&gt;</comment>
                                                            <comment id="189533" author="61cd0ca0bce5e00069e98be7" created="Tue, 20 Feb 2018 13:19:28 +0000"  >&lt;p&gt;Okapi has a raml-util, which is not used but is mentioned in doc/guide.md in section &quot;System Interfaces&quot;.&lt;/p&gt;

&lt;p&gt;It is out-of-date. Either update, or remove and link the docs to the &quot;raml&quot; repository instead.&lt;/p&gt;</comment>
                                                            <comment id="189535" author="61cd0ca0bce5e00069e98be7" created="Tue, 20 Feb 2018 13:19:52 +0000"  >&lt;p&gt;Should shared &quot;raml&quot; repository have a NEWS.md file?&lt;/p&gt;

&lt;p&gt;Should it have actual releases?&lt;/p&gt;</comment>
                                                            <comment id="189536" author="557058:b8e64633-1f7c-402d-9caf-9959a5ba5d0d" created="Wed, 28 Feb 2018 14:46:10 +0000"  >&lt;p&gt;This still seems to be an open issue, with two major points:&lt;/p&gt;

&lt;p&gt;a) the various repos have diverged in terms of raml-util version used, we think it would be beneficial to tag (&quot;release&quot;) the raml repo e.g as 1.1 and align the dependencies across different modules&lt;/p&gt;

&lt;p&gt;b) it seems that the git-submodule approach to publishing and distributing interface definitions is suboptimal and we would benefit from a more robust tool like e.g Maven  (or similar)&lt;/p&gt;

&lt;p&gt;Let&apos;s discuss this on the core meeting next week (with initial discussion here).&lt;/p&gt;</comment>
                                                            <comment id="189538" author="63e2a2771b13d42998e4e706" created="Wed, 28 Feb 2018 14:52:10 +0000"  >&lt;p&gt;&lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=61cd0ca0bce5e00069e98be7&quot; class=&quot;user-hover&quot; rel=&quot;61cd0ca0bce5e00069e98be7&quot; data-account-id=&quot;61cd0ca0bce5e00069e98be7&quot; accountid=&quot;61cd0ca0bce5e00069e98be7&quot; rel=&quot;noreferrer&quot;&gt;David Crossley&lt;/a&gt; From the looks of those changes, I think they&apos;ll have a minimal impact on compatibility. &lt;/p&gt;

&lt;p&gt;If these are the only outstanding changes between the versions modules are on and the current revision, we could likely tag that and update them all to it.&lt;/p&gt;

&lt;p&gt;bq .2018-01-16 : schemas/mod-users/userdata.json : Update userdata with metadata object. Require addressType field for addresstypes&lt;/p&gt;

&lt;p&gt;This is specific to the users modules, so others are unaffected&lt;/p&gt;

&lt;blockquote&gt;&lt;p&gt;2018-01-13 : schemas/resultInfo.schema : Add further diagnostics 
    &lt;span class=&quot;jira-issue-macro resolved&quot; data-jira-key=&quot;MODCXMUX-14&quot; &gt;
                &lt;a href=&quot;https://folio-org.atlassian.net/browse/MODCXMUX-14&quot; class=&quot;jira-issue-macro-key issue-link&quot;  title=&quot;Per-source record-counts, rewritten query&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;
            MODCXMUX-14
        &lt;/a&gt;
                                                    &lt;span class=&quot;aui-lozenge aui-lozenge-subtle aui-lozenge-success jira-macro-single-issue-export-pdf&quot;&gt;Closed&lt;/span&gt;
            &lt;/span&gt;
&lt;/p&gt;&lt;/blockquote&gt;

&lt;p&gt;Those are all additional properties and server owned, so shouldn&apos;t affect compatibility until they are used&lt;/p&gt;

&lt;blockquote&gt;&lt;p&gt;2017-12-08 : raml/schemas/metadata.schema : Fix the UUID pattern 
    &lt;span class=&quot;jira-issue-macro resolved&quot; data-jira-key=&quot;FOLIO-972&quot; &gt;
                &lt;a href=&quot;https://folio-org.atlassian.net/browse/FOLIO-972&quot; class=&quot;jira-issue-macro-key issue-link&quot;  title=&quot;The regex pattern for UUID in schemas does not completely allow mixed-case characters&quot; &gt;
            &lt;img class=&quot;icon&quot; src=&quot;https://folio-org.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10303?size=medium&quot; /&gt;
            FOLIO-972
        &lt;/a&gt;
                                                    &lt;span class=&quot;aui-lozenge aui-lozenge-subtle aui-lozenge-success jira-macro-single-issue-export-pdf&quot;&gt;Closed&lt;/span&gt;
            &lt;/span&gt;
&lt;/p&gt;&lt;/blockquote&gt;

&lt;p&gt;This is an expansion of the valid range (a weakening in effect) and so shouldn&apos;t effect compatibility&lt;/p&gt;</comment>
                                                            <comment id="189540" author="61cd0ca0bce5e00069e98be7" created="Thu, 1 Mar 2018 09:19:18 +0000"  >&lt;p&gt;Thanks, very helpful.&lt;/p&gt;

&lt;p&gt;As per the attached list about half of the repos have raml-util older than that, so will need more investigation. The user-related and codex-related ones are recent, so easier.&lt;/p&gt;</comment>
                                                            <comment id="189542" author="61cd0ca0bce5e00069e98be7" created="Tue, 6 Mar 2018 13:20:09 +0000"  >&lt;p&gt;I reviewed the &quot;raml&quot; repository and each of the other raml-using repositories. Fixed some inconsistencies.&lt;/p&gt;

&lt;p&gt;Also re-generated the attached listing of each project&apos;s date and version of its raml-util git submodule.&lt;/p&gt;</comment>
                                                            <comment id="189545" author="5f8314dfbdef80006f6f572d" created="Fri, 20 Apr 2018 09:08:26 +0000"  >&lt;p&gt;Last label was sprint33. Resolved or forgotten?&lt;/p&gt;</comment>
                                                            <comment id="189547" author="61cd0ca0bce5e00069e98be7" created="Sat, 21 Apr 2018 07:01:29 +0000"  >&lt;p&gt;Essentially done. (Many open issues were not rolled over to other sprints.)&lt;br/&gt;
I will review my notes and tidy up.&lt;/p&gt;

&lt;p&gt;In the meantime i have been attending to semi-related issues.&lt;/p&gt;

&lt;p&gt;Today updated the attached list of which versions of raml-util are currently in use. (Should be a separate issue.)&lt;/p&gt;</comment>
                                                            <comment id="189549" author="61cd0ca0bce5e00069e98be7" created="Mon, 23 Apr 2018 04:08:49 +0000"  >&lt;p&gt;This issue commenced with the title &quot;Split shared raml into separate components&quot;. As per comment #1 we decided to not do that at this stage, but instead to ensure consistency. So modified the title to match.&lt;/p&gt;</comment>
                                                            <comment id="189551" author="61cd0ca0bce5e00069e98be7" created="Mon, 23 Apr 2018 04:09:37 +0000"  >&lt;p&gt;The inconsistencies are fixed. However ongoing monitoring is needed. A script to run raml-cop has been added to each repository (at ./scripts/lint-raml-cop.sh). Note that there are some potential inconsistencies that it does not detect (
    &lt;span class=&quot;jira-issue-macro resolved&quot; data-jira-key=&quot;FOLIO-1220&quot; &gt;
                &lt;a href=&quot;https://folio-org.atlassian.net/browse/FOLIO-1220&quot; class=&quot;jira-issue-macro-key issue-link&quot;  title=&quot;Ensure that all necessary schemas are declared in RAML files&quot; &gt;
            &lt;img class=&quot;icon&quot; src=&quot;https://folio-org.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10303?size=medium&quot; /&gt;
            FOLIO-1220
        &lt;/a&gt;
                                                    &lt;span class=&quot;aui-lozenge aui-lozenge-subtle aui-lozenge-success jira-macro-single-issue-export-pdf&quot;&gt;Closed&lt;/span&gt;
            &lt;/span&gt;
).&lt;/p&gt;</comment>
                                                            <comment id="189552" author="61cd0ca0bce5e00069e98be7" created="Fri, 7 Sep 2018 07:39:31 +0000"  >&lt;p&gt;Closed as done.&lt;/p&gt;

&lt;p&gt;The raml-util is also better with the &quot;raml1.0&quot; branch 
    &lt;span class=&quot;jira-issue-macro resolved&quot; data-jira-key=&quot;RMB-198&quot; &gt;
                &lt;a href=&quot;https://folio-org.atlassian.net/browse/RMB-198&quot; class=&quot;jira-issue-macro-key issue-link&quot;  title=&quot;Update the shared raml repo to follow RMB v20 and so RAML v1&quot; &gt;
            &lt;img class=&quot;icon&quot; src=&quot;https://folio-org.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10318?size=medium&quot; /&gt;
            RMB-198
        &lt;/a&gt;
                                                    &lt;span class=&quot;aui-lozenge aui-lozenge-subtle aui-lozenge-success jira-macro-single-issue-export-pdf&quot;&gt;Closed&lt;/span&gt;
            &lt;/span&gt;
.&lt;/p&gt;

&lt;p&gt;The lint-raml CI job 
    &lt;span class=&quot;jira-issue-macro resolved&quot; data-jira-key=&quot;FOLIO-1027&quot; &gt;
                &lt;a href=&quot;https://folio-org.atlassian.net/browse/FOLIO-1027&quot; class=&quot;jira-issue-macro-key issue-link&quot;  title=&quot;Integrate RAML linting for all raml-based projects in CI&quot; &gt;
            &lt;img class=&quot;icon&quot; src=&quot;https://folio-org.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10318?size=medium&quot; /&gt;
            FOLIO-1027
        &lt;/a&gt;
                                                    &lt;span class=&quot;aui-lozenge aui-lozenge-subtle aui-lozenge-success jira-macro-single-issue-export-pdf&quot;&gt;Closed&lt;/span&gt;
            &lt;/span&gt;
 also helps to verify.&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10003">
                    <name>Relates</name>
                                            <outwardlinks description="relates to">
                                        <issuelink>
            <issuekey id="35254">MODLOGIN-28</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="34202">MODPERMS-31</issuekey>
        </issuelink>
                            </outwardlinks>
                                                                <inwardlinks description="relates to">
                                        <issuelink>
            <issuekey id="80650">FOLIO-1220</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="55714">MODINVSTOR-45</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="35371">MODUSERBL-25</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </issuelinktype>
                    </issuelinks>
                <attachments>
                            <attachment id="64018" name="compare-raml-util-2018042116.txt" size="3791" author="61cd0ca0bce5e00069e98be7" created="Sat, 21 Apr 2018 06:56:20 +0000"/>
                    </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|hzy99z:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10020" key="com.pyxis.greenhopper.jira:gh-sprint">
                        <customfieldname>Sprint</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10024" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>[CHART] Date of First Response</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Wed, 7 Feb 2018 14:15:06 +0000</customfieldvalue>

                        </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>