<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 07:48:51 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-4780] MMS Manual page layout suggestion</title>
                <link>https://jira.mongodb.org/browse/DOCS-4780</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;p&gt;I&apos;m not too sure if this is the best place for this, so feel free to move it if necessary.&lt;/p&gt;

&lt;p&gt;I&apos;ve noticed that the MMS Manual&apos;s page layout is not very responsively designed. Here&apos;s what I&apos;ve observed:&lt;/p&gt;

&lt;p&gt;&lt;b&gt;The Good&lt;/b&gt;&lt;/p&gt;
&lt;ul class=&quot;alternate&quot; type=&quot;square&quot;&gt;
	&lt;li&gt;If you shrink the width of your browser, the left nav disappears and you get a toggle button in the upper left.&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;&lt;b&gt;The Not-So-Good&lt;/b&gt;&lt;/p&gt;
&lt;ul class=&quot;alternate&quot; type=&quot;square&quot;&gt;
	&lt;li&gt;The main content area has a fixed width. So no matter how wide you make the browser, it always occupies the same amount of horizontal space.&lt;/li&gt;
	&lt;li&gt;The right bar (containing &quot;On This Page&quot;, an ad, and the social media buttons) occupies way too much space.&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;I noticed this while looking at one of the Public API reference pages:&lt;br/&gt;
&lt;a href=&quot;https://docs.mms.mongodb.com/reference/api/alert-configurations/#entity-fields&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs.mms.mongodb.com/reference/api/alert-configurations/#entity-fields&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;In the &lt;b&gt;Entity Fields&lt;/b&gt; section, there&apos;s a table that could definitely benefit from more horizontal space.&lt;/p&gt;

&lt;p&gt;So, here are my suggestions:&lt;/p&gt;
&lt;ul class=&quot;alternate&quot; type=&quot;square&quot;&gt;
	&lt;li&gt;Make the container fluid width so it always fills the available horizontal space.&lt;/li&gt;
	&lt;li&gt;Move the &quot;On This Page&quot; block to a drop-down menu in the top nav.&lt;/li&gt;
	&lt;li&gt;Can we get rid of the ad? Or maybe use a different shape that can be affixed below the header?&lt;/li&gt;
	&lt;li&gt;Move the social media buttons and &quot;Report a Problem&quot; link into a footer.&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;CC: &lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=marc.gurney%4010gen.com&quot; class=&quot;user-hover&quot; rel=&quot;marc.gurney@10gen.com&quot;&gt;marc.gurney@10gen.com&lt;/a&gt;&lt;/p&gt;</description>
                <environment></environment>
        <key id="182718">DOCS-4780</key>
            <summary>MMS Manual page layout suggestion</summary>
                <type id="4" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14710&amp;avatarType=issuetype">Improvement</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="-1">Unassigned</assignee>
                                    <reporter username="michael.benoit@mongodb.com">Michael Benoit</reporter>
                        <labels>
                    </labels>
                <created>Thu, 5 Feb 2015 15:59:57 +0000</created>
                <updated>Wed, 11 Jan 2017 22:38:23 +0000</updated>
                            <resolved>Thu, 5 Feb 2015 19:53:42 +0000</resolved>
                                                    <fixVersion>01112017-cleanup</fixVersion>
                                    <component>Cloud Manager</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>2</watches>
                                                                                                                <comments>
                            <comment id="822635" author="michael.benoit@10gen.com" created="Thu, 5 Feb 2015 19:53:30 +0000"  >&lt;p&gt;Fair enough &amp;#8211; thanks &lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=marc.gurney%4010gen.com&quot; class=&quot;user-hover&quot; rel=&quot;marc.gurney@10gen.com&quot;&gt;marc.gurney@10gen.com&lt;/a&gt;!&lt;/p&gt;</comment>
                            <comment id="822537" author="marc.gurney@10gen.com" created="Thu, 5 Feb 2015 18:10:01 +0000"  >&lt;p&gt;Propose to resolve as &quot;Works as Designed&quot;&lt;/p&gt;</comment>
                            <comment id="822534" author="marc.gurney@10gen.com" created="Thu, 5 Feb 2015 18:08:17 +0000"  >&lt;p&gt;We do not want the content column to be 100% width, the max-width is there to optimize for legibility. This is a basic rule of typography and it is the reason that well designed documentation sites, blogs, printed textbooks, etc. have a fixed max-column-width.&lt;/p&gt;

&lt;p&gt;&quot;Measure (or sometimes &quot;The Measure&quot;) in typography is the length of a line of text. For a single-column design measure should ideally lie between 40 and 80 characters. Many typographers consider the perfect measure to be 65 characters. If the lines are too short then the text becomes disjointed, if they are too long the content loses rhythm as the reader searches for the start of each line. Punctuation should preferably hang outside the measure.&quot;&lt;/p&gt;
&lt;ul class=&quot;alternate&quot; type=&quot;square&quot;&gt;
	&lt;li&gt;&lt;a href=&quot;https://en.wikipedia.org/wiki/Measure_(typography&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://en.wikipedia.org/wiki/Measure_(typography&lt;/a&gt;)&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;The max-width on the content column of MongoDB and MMS Docs currently averages around 100 characters per line. We do not want to make this column any wider. The right sidebar automatically drops off on smaller screen sizes (good) and the left sidebar auto-hides on even smaller screen sizes (good).&lt;/p&gt;

&lt;p&gt;The measure for the right table-cell (&quot;Description&quot; column) is in the high 70s, still at the upper range of the ideal 40-80, and it seems perfectly legible to me when reading the content as I normally would read content on a page. I do find it hard to read the lists of &quot;possible values&quot; though, I think those could maybe be one per line. But that&apos;s a separate issue.&lt;/p&gt;

&lt;p&gt;(average measure)&lt;br/&gt;
&lt;a href=&quot;https://docs.mms.mongodb.com/reference/api/hosts/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs.mms.mongodb.com/reference/api/hosts/&lt;/a&gt; (100)&lt;br/&gt;
&lt;a href=&quot;https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array&lt;/a&gt; (100)&lt;br/&gt;
&lt;a href=&quot;http://getbootstrap.com/css/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://getbootstrap.com/css/&lt;/a&gt; (130)&lt;br/&gt;
&lt;a href=&quot;https://help.ubuntu.com/lts/serverguide/openvpn.html&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://help.ubuntu.com/lts/serverguide/openvpn.html&lt;/a&gt; (150)&lt;br/&gt;
&lt;a href=&quot;http://docs.basho.com/riak/latest/ops/running/cluster-admin/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://docs.basho.com/riak/latest/ops/running/cluster-admin/&lt;/a&gt; (75)&lt;br/&gt;
&lt;a href=&quot;https://medium.com/@fat/mediums-css-is-actually-pretty-fucking-good-b8e2a6c78b06&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://medium.com/@fat/mediums-css-is-actually-pretty-fucking-good-b8e2a6c78b06&lt;/a&gt; (75)&lt;br/&gt;
&lt;a href=&quot;http://www.nytimes.com/2014/12/09/science/-stronger-signs-of-life-on-mars.html?ref=science&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://www.nytimes.com/2014/12/09/science/-stronger-signs-of-life-on-mars.html?ref=science&lt;/a&gt; (75)&lt;/p&gt;
</comment>
                    </comments>
                    <attachments>
                            <attachment id="63874" name="Screen Shot 2015-02-05 at 11.35.07 AM.png" size="80625" author="marc.gurney@mongodb.com" created="Thu, 5 Feb 2015 18:08:48 +0000"/>
                            <attachment id="63875" name="Screen Shot 2015-02-05 at 12.23.33 PM.png" size="69548" author="marc.gurney@mongodb.com" created="Thu, 5 Feb 2015 18:08:48 +0000"/>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                <customfield id="customfield_10050" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname># Replies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>3.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Thu, 5 Feb 2015 18:08:17 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        9 years, 1 week, 6 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_10057" key="com.atlassian.jira.toolkit:lastusercommented">
                        <customfieldname>Last comment by Customer</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>true</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10056" key="com.atlassian.jira.toolkit:lastupdaterorcommenter">
                        <customfieldname>Last commenter</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>jess.mokrzecki@mongodb.com</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_11151" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            9 years, 1 week, 6 days ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>marc.gurney@mongodb.com</customfieldvalue>
            <customfieldvalue>michael.benoit@mongodb.com</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hrqjs7:</customfieldvalue>

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

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10558" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>160567</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|hrzmzb:</customfieldvalue>

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