<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Wed Feb 07 21:14:15 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>[CDRIVER-2122] Issues in documentation for read concern option &quot;level&quot;</title>
                <link>https://jira.mongodb.org/browse/CDRIVER-2122</link>
                <project id="10030" key="CDRIVER">C Driver</project>
                    <description>&lt;p&gt;There are several issues in the mongoc_read_concern_t documentation regarding the server default read concern:&lt;/p&gt;
&lt;ol&gt;
	&lt;li&gt;The documentation for &lt;a href=&quot;http://mongoc.org/libmongoc/current/mongoc_read_concern_get_level.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;mongoc_read_concern_get_level &lt;/a&gt; states that the empty string is returned when no read concern is set.  However, 1.6.2, NULL is returned in this case, not the empty string.&lt;/li&gt;
	&lt;li&gt;Similarly, the documentation for &lt;a href=&quot;http://mongoc.org/libmongoc/current/mongoc_read_concern_t.html#synopsis&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;read_concern_t&lt;/a&gt; contains the same error regarding the empty string, in the &quot;Synopsis&quot; section.&lt;/li&gt;
	&lt;li&gt;The documentation for &lt;a href=&quot;http://mongoc.org/libmongoc/current/mongoc_read_concern_set_level.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;mongoc_read_concern_set_level&lt;/a&gt; does not state how to set the server default read concern (the current wording implies that neither NULL nor the empty string are valid values to pass in for &quot;level&quot;).&lt;/li&gt;
&lt;/ol&gt;


&lt;p&gt;On a related note, the wording for the documentation of the parameter &quot;level&quot; in mongoc_read_concern_set_level() could be improved for the driver to be in better compliance with the Read and Write Concern spec.  In particular, the spec &lt;a href=&quot;https://github.com/mongodb/specifications/blob/master/source/read-write-concern/read-write-concern.rst#unknown-levels-and-additional-options-for-string-based-readconcerns&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;states&lt;/a&gt;: &quot;For forward compatibility, a driver MUST NOT raise an error when a user provides an unknown level...&quot;.  In the hypothetical scenario where MongoDB 3.6 is released with a new read concern &quot;foo&quot;, the C driver 1.6.2 documentation implies that &quot;foo&quot; is not a valid value to pass into the mongoc_read_concern_set_level() function when connected to this server.&lt;/p&gt;</description>
                <environment></environment>
        <key id="371676">CDRIVER-2122</key>
            <summary>Issues in documentation for read concern option &quot;level&quot;</summary>
                <type id="1" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14703&amp;avatarType=issuetype">Bug</type>
                                            <priority id="3" iconUrl="https://jira.mongodb.org/images/icons/priorities/major.svg">Major - P3</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="9">Done</resolution>
                                        <assignee username="jesse@mongodb.com">A. Jesse Jiryu Davis</assignee>
                                    <reporter username="rassi">J Rassi</reporter>
                        <labels>
                    </labels>
                <created>Thu, 6 Apr 2017 19:26:28 +0000</created>
                <updated>Sat, 6 May 2017 01:00:24 +0000</updated>
                            <resolved>Sat, 6 May 2017 01:00:16 +0000</resolved>
                                                    <fixVersion>1.7.0</fixVersion>
                                    <component>docs</component>
                                        <votes>0</votes>
                                    <watches>2</watches>
                                                                                                                <comments>
                            <comment id="1566178" author="xgen-internal-githook" created="Sat, 6 May 2017 01:00:24 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{u&apos;username&apos;: u&apos;ajdavis&apos;, u&apos;name&apos;: u&apos;A. Jesse Jiryu Davis&apos;, u&apos;email&apos;: u&apos;jesse@mongodb.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/CDRIVER-2122&quot; title=&quot;Issues in documentation for read concern option &amp;quot;level&amp;quot;&quot; class=&quot;issue-link&quot; data-issue-key=&quot;CDRIVER-2122&quot;&gt;&lt;del&gt;CDRIVER-2122&lt;/del&gt;&lt;/a&gt; update readConcern docs&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/mongo-c-driver/commit/bd105b95489a1b2e34e114b4802f5c858af8da54&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/mongo-c-driver/commit/bd105b95489a1b2e34e114b4802f5c858af8da54&lt;/a&gt;&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10010">
                    <name>Duplicate</name>
                                                                <inwardlinks description="is duplicated by">
                                        <issuelink>
            <issuekey id="320361">CXX-1062</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </issuelinktype>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                            <outwardlinks description="related to">
                                        <issuelink>
            <issuekey id="371684">CXX-1302</issuekey>
        </issuelink>
                            </outwardlinks>
                                                        </issuelinktype>
                    </issuelinks>
                <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_15850" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hrau9b:</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_10557" key="com.pyxis.greenhopper.jira:gh-sprint">
                        <customfieldname>Sprint</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue id="1666">C Driver 2017 3 - March 8</customfieldvalue>

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