<!-- 
RSS generated by JIRA (1001.0.0-SNAPSHOT#100246-sha1:7a5c50119eb0633d306e14180817ddef5e80c75d) at Thu Feb 08 23:16:48 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-1912] Aggregate metadata about RAMLs configuration from all RAML-based repos</title>
                <link>https://folio-org.atlassian.net/browse/FOLIO-1912</link>
                <project id="10290" key="FOLIO">FOLIO</project>
                    <description>&lt;p&gt;The dev.folio.org website Jekyll Liquid code that generates the &quot;&lt;a href=&quot;https://dev.folio.org/reference/api/&quot; class=&quot;external-link&quot; rel=&quot;nofollow noreferrer&quot;&gt;Reference API documentation&lt;/a&gt;&quot; tables needs to be efficient, so requires a pre-prepared up-to-date data file.&lt;/p&gt;

&lt;p&gt;Currently it uses the manually maintained &lt;a href=&quot;https://dev.folio.org/reference/api/#configure-api-docs&quot; class=&quot;external-link&quot; rel=&quot;nofollow noreferrer&quot;&gt;api.yml data file&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;As explained in 
    &lt;span class=&quot;jira-issue-macro&quot; data-jira-key=&quot;FOLIO-1911&quot; &gt;
                &lt;a href=&quot;https://folio-org.atlassian.net/browse/FOLIO-1911&quot; class=&quot;jira-issue-macro-key issue-link&quot;  title=&quot;Enhance generate-api-docs to record metadata about &amp;quot;interface&amp;quot; and &amp;quot;version&amp;quot; each RAML file&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-1911
        &lt;/a&gt;
                                                    &lt;span class=&quot;aui-lozenge aui-lozenge-subtle aui-lozenge-complete jira-macro-single-issue-export-pdf&quot;&gt;Open&lt;/span&gt;
            &lt;/span&gt;
, the generate-api-docs CI job assembles and deploys a summary metadata file to AWS S3 for that particular raml-based repository.&lt;/p&gt;

&lt;p&gt;Add a new Jenkins automation job, to regularly gather the metadata file for each repository, and then consolidate it into one single file.&lt;/p&gt;

&lt;p&gt;Publish this file so that it is available for Jekyll.&lt;/p&gt;

&lt;p&gt;Ideally it would be committed to the dev website source repository &quot;&lt;a href=&quot;https://github.com/folio-org/folio-org.github.io/tree/master/_data&quot; class=&quot;external-link&quot; rel=&quot;nofollow noreferrer&quot;&gt;_data&lt;/a&gt;&quot; directory, where it can be automatically utilised by Jekyll Liquid.&lt;/p&gt;

&lt;p&gt;Otherwise it can be deployed to the top-level &lt;a href=&quot;https://s3.amazonaws.com/foliodocs/api/config.json&quot; class=&quot;external-link&quot; rel=&quot;nofollow noreferrer&quot;&gt;API docs space&lt;/a&gt; on AWS S3. Then an additional facility would be required by our Jekyll to retrieve that data file, at website generation time. This would require developing a &lt;a href=&quot;https://jekyllrb.com/docs/plugins/tags/&quot; class=&quot;external-link&quot; rel=&quot;nofollow noreferrer&quot;&gt;Jekyll plugin for custom Liquid Tags&lt;/a&gt; (a small Ruby script).&lt;/p&gt;

&lt;p&gt;Acceptance criteria:&lt;br/&gt;
The aggregated metadata file is published.&lt;/p&gt;

&lt;p&gt;Update: 2022-09-01 This is now handled by 
    &lt;span class=&quot;jira-issue-macro resolved&quot; data-jira-key=&quot;FOLIO-2922&quot; &gt;
                &lt;a href=&quot;https://folio-org.atlassian.net/browse/FOLIO-2922&quot; class=&quot;jira-issue-macro-key issue-link&quot;  title=&quot;Automate the configuration of API documentation&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-2922
        &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;</description>
                <environment></environment>
        <key id="81130">FOLIO-1912</key>
            <summary>Aggregate metadata about RAMLs configuration from all RAML-based repos</summary>
                <type id="10002" iconUrl="https://folio-org.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10322?size=medium">New Feature</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="10001">Duplicate</resolution>
                                                        <assignee accountid="61cd0ca0bce5e00069e98be7">David Crossley</assignee>
                                                                <reporter accountid="61cd0ca0bce5e00069e98be7">David Crossley</reporter>
                                    <labels>
                            <label>raml</label>
                    </labels>
                <created>Tue, 26 Mar 2019 06:06:53 +0000</created>
                <updated>Thu, 1 Sep 2022 07:47:56 +0000</updated>
                            <resolved>Thu, 1 Sep 2022 07:47:56 +0000</resolved>
                                                                        <due></due>
                            <votes>0</votes>
                                    <watches>1</watches>
                                                                    <issuelinks>
                            <issuelinktype id="10000">
                    <name>Blocks</name>
                                            <outwardlinks description="blocks">
                                        <issuelink>
            <issuekey id="79579">FOLIO-1913</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="80673">FOLIO-1316</issuekey>
        </issuelink>
                            </outwardlinks>
                                                                <inwardlinks description="is blocked by">
                                        <issuelink>
            <issuekey id="79578">FOLIO-1911</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </issuelinktype>
                            <issuelinktype id="10002">
                    <name>Duplicate</name>
                                                                <inwardlinks description="is duplicated by">
                                        <issuelink>
            <issuekey id="81925">FOLIO-2922</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </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_10057" key="com.atlassian.jira.plugin.system.customfieldtypes:select">
                        <customfieldname>Development Team</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue key="10155"><![CDATA[FOLIO DevOps]]></customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10019" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0|hzzk7r:</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>