<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 07:58:13 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 append 'field=key&field=summary' to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>MongoDB Jira</title>
    <link>https://jira.mongodb.org</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>9.7.1</version>
        <build-number>970001</build-number>
        <build-date>13-04-2023</build-date>
    </build-info>


<item>
            <title>[DOCS-9368] Awkward phrasing in Collations documentation</title>
                <link>https://jira.mongodb.org/browse/DOCS-9368</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;p&gt;On the &lt;a href=&quot;https://docs.mongodb.com/master/reference/collation/#collation-document-fields&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Collation reference page&lt;/a&gt;, it says (in two locations): &lt;/p&gt;

&lt;p&gt;&quot;Limited for specific use case...&quot; (emphasis mine)&lt;/p&gt;

&lt;p&gt;I think the wording gets the point across, but they&apos;re not syntactically correct sentences.&lt;/p&gt;

&lt;p&gt;Here are the full sentences (plus the label):&lt;/p&gt;

&lt;ul&gt;
	&lt;li&gt;&quot;Quaternary Level. Limited for specific use case to consider punctuation when levels 1-3 ignore punctuation or for processing Japanese text.&quot;
	&lt;ul&gt;
		&lt;li&gt;Perhaps the intention was something like, &quot;Limited to the specific use case where it&apos;s necessary to consider punctuation, but levels 1-3 ignore punctuation for the language. Also used for processing Japanese text.&quot;&lt;/li&gt;
	&lt;/ul&gt;
	&lt;/li&gt;
&lt;/ul&gt;


&lt;ul&gt;
	&lt;li&gt;&quot;Identical Level. Limited for specific use case of tie breaker.&quot;
	&lt;ul&gt;
		&lt;li&gt;Perhaps the intention was something like, &quot;Identical to level 4 in most respects. The only difference in ordering occurs in the specific use case where a tie breaker is required.&quot;&lt;/li&gt;
	&lt;/ul&gt;
	&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;This might also be a good place for an example; I&apos;m not sure what is meant by &quot;tie breaker&quot; in this context, or when punctuation affects ordering; maybe it never does affect ordering for English, which is, alas, my only fluent language.&lt;/p&gt;

&lt;p&gt;(Note: I don&apos;t think I made any mistakes in this, but I&apos;m definitely in &lt;a href=&quot;https://en.wikipedia.org/wiki/Muphry&amp;#39;s_law&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Muphry&apos;s Law&lt;/a&gt; territory any time I create a Docs ticket. Also, please let me know if I should fill these out on the public facing Jira project.)&lt;/p&gt;</description>
                <environment></environment>
        <key id="333033">DOCS-9368</key>
            <summary>Awkward phrasing in Collations documentation</summary>
                <type id="1" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14703&amp;avatarType=issuetype">Bug</type>
                                            <priority id="4" iconUrl="https://jira.mongodb.org/images/icons/priorities/minor.svg">Minor - P4</priority>
                        <status id="6" iconUrl="https://jira.mongodb.org/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="success"/>
                                    <resolution id="12300">Won&apos;t Do</resolution>
                                        <assignee username="-1">Unassigned</assignee>
                                    <reporter username="william.cross">William Cross</reporter>
                        <labels>
                    </labels>
                <created>Fri, 18 Nov 2016 23:32:49 +0000</created>
                <updated>Mon, 30 Oct 2023 22:24:47 +0000</updated>
                                                            <fixVersion>Server_Docs_20231030</fixVersion>
                                    <component>manual</component>
                    <component>Server</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>6</watches>
                                                                                                                <comments>
                            <comment id="4940863" author="edu.bot" created="Mon, 31 Oct 2022 16:12:05 +0000"  >&lt;p&gt;Hello! This ticket has been closed due to inactivity. If you believe this ticket is still important, please reopen it and leave a comment to explain why. Thank you!&lt;/p&gt;</comment>
                            <comment id="1451248" author="david.storch" created="Wed, 7 Dec 2016 15:05:22 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=steve.renaker&quot; class=&quot;user-hover&quot; rel=&quot;steve.renaker&quot;&gt;steve.renaker&lt;/a&gt;, that is not correct. The default unicode collation element table (DUCET) does include characters that are ignorable at levels 1 through 3 but have a non-zero weight at levels 4 or 5. I believe that these quaternary or level 5 collation elements are not considered variable-weight characters, so their behavior is not affected by &lt;tt&gt;maxVariable&lt;/tt&gt; or &lt;tt&gt;alternate&lt;/tt&gt;. According to &lt;a href=&quot;http://unicode.org/reports/tr10/#DUCET_Order_Table&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;Table 13 of UTS #10&lt;/a&gt;, this includes control codes and format characters, as well as Hebrew points and Arabic tatweel. For example, if you look at the representation of the DUCET in &lt;a href=&quot;http://www.unicode.org/Public/UCA/latest/allkeys.txt&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://www.unicode.org/Public/UCA/latest/allkeys.txt&lt;/a&gt;, you can find the following line:&lt;/p&gt;

&lt;p/&gt;
&lt;div id=&quot;syntaxplugin&quot; class=&quot;syntaxplugin&quot; style=&quot;border: 1px dashed #bbb; border-radius: 5px !important; overflow: auto; max-height: 30em;&quot;&gt;
&lt;table cellspacing=&quot;0&quot; cellpadding=&quot;0&quot; border=&quot;0&quot; width=&quot;100%&quot; style=&quot;font-size: 1em; line-height: 1.4em !important; font-weight: normal; font-style: normal; color: black;&quot;&gt;
		&lt;tbody &gt;
				&lt;tr id=&quot;syntaxplugin_code_and_gutter&quot;&gt;
						&lt;td  style=&quot; line-height: 1.4em !important; padding: 0em; vertical-align: top;&quot;&gt;
					&lt;pre style=&quot;font-size: 1em; margin: 0 10px;  margin-top: 10px;   margin-bottom: 10px;  width: auto; padding: 0;&quot;&gt;&lt;span style=&quot;color: black; font-family: &apos;Consolas&apos;, &apos;Bitstream Vera Sans Mono&apos;, &apos;Courier New&apos;, Courier, monospace !important;&quot;&gt;0640  ; [.0000.0000.0000] # ARABIC TATWEEL&lt;/span&gt;&lt;/pre&gt;
			&lt;/td&gt;
		&lt;/tr&gt;
			&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;
&lt;p/&gt;

&lt;p&gt;This means that the tatweel character, U+0640, has primary, secondary, and tertiary weights of zero, which is represented by the zeros between the brackets: [.0000.0000.0000]. The DUCET does not include level 4 or level 5 weights, so I&apos;m actually not sure right now whether U+0640 is a quaternary collation element or a level 5 collation element which only takes affect at &lt;tt&gt;strength:5&lt;/tt&gt;. But hopefully this still helps to clarify. My guess is that the Arabic tatweel as well as control/format characters are only taken into consideration at &lt;tt&gt;strength:5&lt;/tt&gt;.&lt;/p&gt;

&lt;p&gt;Also note that tailorings of the DUCET could change a character to have level 4 or level 5 weights. For example, some hypothetical language might want to change the combining character for tilde, U+0303, to only take affect at the quaternary level. By default it would be a secondary collation element like other diacritics, but that doesn&apos;t mean such a tailoring couldn&apos;t exist in theory.&lt;/p&gt;</comment>
                            <comment id="1450873" author="steve.renaker" created="Tue, 6 Dec 2016 23:31:43 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=david.storch&quot; class=&quot;user-hover&quot; rel=&quot;david.storch&quot;&gt;david.storch&lt;/a&gt; Returning to considerations of the collation &lt;tt&gt;strength&lt;/tt&gt; parameter. Is it correct to say that &lt;tt&gt;strength&lt;/tt&gt; only has an effect on the sort order of strings with punctuation if &lt;tt&gt;alternate&lt;/tt&gt; is set to &lt;tt&gt;shifted&lt;/tt&gt;? I can&apos;t find any examples to the contrary, but I may not be using it correctly.&lt;/p&gt;</comment>
                            <comment id="1443561" author="steve.renaker" created="Mon, 28 Nov 2016 17:40:06 +0000"  >&lt;p&gt;Reply received from engineering. Thanks to David for clarifying the use of strength parameter 4.&lt;/p&gt;</comment>
                            <comment id="1443523" author="steve.renaker" created="Mon, 28 Nov 2016 17:08:54 +0000"  >&lt;p&gt;I think we have some incorrect lines in the page this ticket is about. I&apos;ve emailed engineering to confirm.&lt;/p&gt;</comment>
                    </comments>
                    <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                <customfield id="customfield_10050" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname># Replies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>5.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Tue, 22 Nov 2016 21:50:05 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        1 year, 14 weeks, 2 days ago
    
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_18254" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname>Dependencies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue><![CDATA[]]></customfieldvalue>


                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_15850" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10857" key="com.pyxis.greenhopper.jira:gh-epic-link">
                        <customfieldname>Epic Link</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>DOCSP-1769</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                        <customfield id="customfield_10040" key="com.atlassian.jira.plugin.system.customfieldtypes:select">
                        <customfieldname>Estimate</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue key="10042"><![CDATA[Small]]></customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10057" key="com.atlassian.jira.toolkit:lastusercommented">
                        <customfieldname>Last comment by Customer</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>false</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10056" key="com.atlassian.jira.toolkit:lastupdaterorcommenter">
                        <customfieldname>Last commenter</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>emet.ozar@mongodb.com</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_11151" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            1 year, 14 weeks, 2 days ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>david.storch@mongodb.com</customfieldvalue>
            <customfieldvalue>edu.bot</customfieldvalue>
            <customfieldvalue>steve.renaker@mongodb.com</customfieldvalue>
            <customfieldvalue>william.cross</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hrmcc7:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hr86jb:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10558" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>9223372036854775807</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10555" key="com.atlassian.jira.plugin.system.customfieldtypes:float">
                        <customfieldname>Story Points</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0.25</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_10053" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>Time In Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_14350" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>serverRank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hrzhjz:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                </customfields>
    </item>
</channel>
</rss>