{"id":1307,"date":"2015-03-25T16:45:33","date_gmt":"2015-03-25T20:45:33","guid":{"rendered":"https:\/\/blogs.mathworks.com\/steve\/?p=1307"},"modified":"2019-11-01T11:38:31","modified_gmt":"2019-11-01T15:38:31","slug":"new-online-documentation-system-for-r2015a","status":"publish","type":"post","link":"https:\/\/blogs.mathworks.com\/steve\/2015\/03\/25\/new-online-documentation-system-for-r2015a\/","title":{"rendered":"New online documentation system for R2015a"},"content":{"rendered":"<div class=\"content\"><p>Earlier this month we shipped <a href=\"https:\/\/www.mathworks.com\/products\/new_products\/latest_features.html?s_tid=hp_spot_R2015a_0315\">R2015a<\/a>, the first of our <a href=\"https:\/\/www.mathworks.com\/products\/new_products\/release_model.html\">two regularly scheduled annual releases<\/a>. Typically, when there's a new release, I spend some time talking about features that interest me. The feature I want to mention today, though, is a little unusual because it benefits users who haven't even upgraded to the new release yet.<\/p><p>With R2015a, our Documentation and Documentation Tools teams have overhauled the <a href=\"https:\/\/www.mathworks.com\/help\/\">online documentation on mathworks.com<\/a>. We've learned a lot from your feedback since the last major documentation overhaul a few years ago, and we are excited about the changes.<\/p><p>I'll use the <a href=\"https:\/\/www.mathworks.com\/help\/matlab\/ref\/repelem.html\"><tt>repelem<\/tt> reference page<\/a> to show you just a few pieces of it. First, notice that the left-side navigation shows you the product (MATLAB) as well as several information categories (<a href=\"https:\/\/www.mathworks.com\/help\/matlab\/language-fundamentals.html\">Language Fundamentals<\/a>, <a href=\"https:\/\/www.mathworks.com\/help\/matlab\/matrices-and-arrays.html\">Matrices and Arrays<\/a>, and <a title=\"https:\/\/www.mathworks.com\/help\/matlab\/array-manipulation.html (link no longer works)\">Sorting and Reshaping Arrays<\/a>) that are relevant to <tt>repelem<\/tt>.<\/p><p><img decoding=\"async\" vspace=\"5\" hspace=\"5\" src=\"https:\/\/blogs.mathworks.com\/images\/steve\/2015\/repelem-doc-screenshot-1.png\" alt=\"\"> <\/p><p>Next, notice the \"i\" icon to the right of the product name, MATLAB. Click on this icon to get to a standard set of product information, including <a href=\"https:\/\/www.mathworks.com\/help\/matlab\/getting-started-with-matlab.html\">Getting Started<\/a>, <a href=\"https:\/\/www.mathworks.com\/help\/matlab\/examples.html\">Examples<\/a>, <a href=\"\">Functions and Other Reference<\/a>, <a href=\"https:\/\/www.mathworks.com\/help\/matlab\/release-notes.html\">Release Notes<\/a>, and <a href=\"https:\/\/www.mathworks.com\/help\/releases\/R2015a\/pdf_doc\/matlab\/index.html\">PDF Documentation<\/a>.<\/p><p><img decoding=\"async\" vspace=\"5\" hspace=\"5\" src=\"https:\/\/blogs.mathworks.com\/images\/steve\/2015\/repelem-doc-screenshot-2.png\" alt=\"\"> <\/p><p>The left-side navigation also helps you easily see and get around to all the information that's available on the page you're looking at. Below, the left-side navigation is shown directing you to information about <a href=\"https:\/\/www.mathworks.com\/help\/matlab\/ref\/repelem.html#input_argument_n\">one of the input arguments<\/a> for <tt>repelem<\/tt>.<\/p><p><img decoding=\"async\" vspace=\"5\" hspace=\"5\" src=\"https:\/\/blogs.mathworks.com\/images\/steve\/2015\/repelem-doc-screenshot-3.png\" alt=\"\"> <\/p><p>Now if you haven't upgraded to R2015a yet, and if you've tried to use <tt>repelem<\/tt> in your MATLAB, then you've already noticed that <tt>repelem<\/tt> isn't there. If you scroll all the way down on <tt>repelem<\/tt> reference page, it shows you why:<\/p><p><img decoding=\"async\" vspace=\"5\" hspace=\"5\" src=\"https:\/\/blogs.mathworks.com\/images\/steve\/2015\/repelem-doc-screenshot-4.png\" alt=\"\"> <\/p><p>You can see that <tt>repelem<\/tt> is new in R2015a! Customers have long been asking us to provide this information on function reference pages. (Please note that the \"introduced in\" information is not available for all functions yet. It will take us some time to update every page.)<\/p><p>Finally, the new document system displays reference pages and other content very nicely on mobile devices. Here is a screenshot from my phone:<\/p><p><img decoding=\"async\" vspace=\"5\" hspace=\"5\" src=\"https:\/\/blogs.mathworks.com\/images\/steve\/2015\/repelem-doc-screenshot-phone.png\" alt=\"\"> <\/p><p>We'd like to know what you think about the new online doc. That would help our teams as they bring these updates to the documentation system that's included with the product. If you have any feedback you'd like to share, please leave a comment below.<\/p><script language=\"JavaScript\"> <!-- \r\n    function grabCode_5a00c9cdc9ab42fbadd836f1799dbcd0() {\r\n        \/\/ Remember the title so we can use it in the new page\r\n        title = document.title;\r\n\r\n        \/\/ Break up these strings so that their presence\r\n        \/\/ in the Javascript doesn't mess up the search for\r\n        \/\/ the MATLAB code.\r\n        t1='5a00c9cdc9ab42fbadd836f1799dbcd0 ' + '##### ' + 'SOURCE BEGIN' + ' #####';\r\n        t2='##### ' + 'SOURCE END' + ' #####' + ' 5a00c9cdc9ab42fbadd836f1799dbcd0';\r\n    \r\n        b=document.getElementsByTagName('body')[0];\r\n        i1=b.innerHTML.indexOf(t1)+t1.length;\r\n        i2=b.innerHTML.indexOf(t2);\r\n \r\n        code_string = b.innerHTML.substring(i1, i2);\r\n        code_string = code_string.replace(\/REPLACE_WITH_DASH_DASH\/g,'--');\r\n\r\n        \/\/ Use \/x3C\/g instead of the less-than character to avoid errors \r\n        \/\/ in the XML parser.\r\n        \/\/ Use '\\x26#60;' instead of '<' so that the XML parser\r\n        \/\/ doesn't go ahead and substitute the less-than character. \r\n        code_string = code_string.replace(\/\\x3C\/g, '\\x26#60;');\r\n\r\n        copyright = 'Copyright 2015 The MathWorks, Inc.';\r\n\r\n        w = window.open();\r\n        d = w.document;\r\n        d.write('<pre>\\n');\r\n        d.write(code_string);\r\n\r\n        \/\/ Add copyright line at the bottom if specified.\r\n        if (copyright.length > 0) {\r\n            d.writeln('');\r\n            d.writeln('%%');\r\n            if (copyright.length > 0) {\r\n                d.writeln('% _' + copyright + '_');\r\n            }\r\n        }\r\n\r\n        d.write('<\/pre>\\n');\r\n\r\n        d.title = title + ' (MATLAB code)';\r\n        d.close();\r\n    }   \r\n     --> <\/script><p style=\"text-align: right; font-size: xx-small; font-weight:lighter;   font-style: italic; color: gray\"><br><a href=\"javascript:grabCode_5a00c9cdc9ab42fbadd836f1799dbcd0()\"><span style=\"font-size: x-small;        font-style: italic;\">Get \r\n      the MATLAB code <noscript>(requires JavaScript)<\/noscript><\/span><\/a><br><br>\r\n      Published with MATLAB&reg; R2015a<br><\/p><p class=\"footer\"><br>\r\n      Published with MATLAB&reg; R2015a<br><\/p><\/div><!--\r\n5a00c9cdc9ab42fbadd836f1799dbcd0 ##### SOURCE BEGIN #####\r\n%%\r\n% Earlier this month we shipped\r\n% <https:\/\/www.mathworks.com\/products\/new_products\/latest_features.html?s_tid=hp_spot_R2015a_0315\r\n% R2015a>, the first of our\r\n% <https:\/\/www.mathworks.com\/products\/new_products\/release_model.html two\r\n% regularly scheduled annual releases>. Typically, when there's a new\r\n% release, I spend some time talking about features that interest me. The\r\n% feature I want to mention today, though, is a little unusual because it\r\n% benefits users who haven't even upgraded to the new release yet.\r\n%\r\n% With R2015a, our Documentation and Documentation Tools teams have\r\n% overhauled the <https:\/\/www.mathworks.com\/help\/ online documentation on\r\n% mathworks.com>. We've learned a lot from your feedback since the last\r\n% major documentation overhaul a few years ago, and we are excited about\r\n% the changes.\r\n%\r\n% I'll use the <https:\/\/www.mathworks.com\/help\/matlab\/ref\/repelem.html \r\n% |repelem| reference page> to show you just a few pieces of\r\n% it. First, notice that the left-side navigation shows you the product\r\n% (MATLAB) as well as several information categories\r\n% (<https:\/\/www.mathworks.com\/help\/matlab\/language-fundamentals.html\r\n% Language Fundamentals>,\r\n% <https:\/\/www.mathworks.com\/help\/matlab\/matrices-and-arrays.html Matrices\r\n% and Arrays>, and\r\n% <https:\/\/www.mathworks.com\/help\/matlab\/array-manipulation.html Sorting and\r\n% Reshaping Arrays>) that are relevant to |repelem|.\r\n%\r\n% <<https:\/\/blogs.mathworks.com\/images\/steve\/2015\/repelem-doc-screenshot-1.png>>\r\n%\r\n% Next, notice the \"i\" icon to the right of the product name, MATLAB. Click\r\n% on this icon to get to a standard set of product information, including\r\n% <https:\/\/www.mathworks.com\/help\/matlab\/getting-started-with-matlab.html\r\n% Getting Started>, <https:\/\/www.mathworks.com\/help\/matlab\/examples.html\r\n% Examples>, <\r\n% Functions and Other Reference>,\r\n% <https:\/\/www.mathworks.com\/help\/matlab\/release-notes.html Release Notes>,\r\n% and\r\n% <https:\/\/www.mathworks.com\/help\/releases\/R2015a\/pdf_doc\/matlab\/index.html\r\n% PDF Documentation>.\r\n%\r\n% <<https:\/\/blogs.mathworks.com\/images\/steve\/2015\/repelem-doc-screenshot-2.png>>\r\n%\r\n% The left-side navigation also helps you easily see and get around to all\r\n% the information that's available on the page you're looking at. Below,\r\n% the left-side navigation is shown directing you to information about\r\n% <https:\/\/www.mathworks.com\/help\/matlab\/ref\/repelem.html#input_argument_n\r\n% one of the input arguments> for |repelem|.\r\n%\r\n% <<https:\/\/blogs.mathworks.com\/images\/steve\/2015\/repelem-doc-screenshot-3.png>>\r\n%\r\n% Now if you haven't upgraded to R2015a yet, and if you've tried to use\r\n% |repelem| in your MATLAB, then you've already noticed that |repelem|\r\n% isn't there. If you scroll all the way down on |repelem| reference page,\r\n% it shows you why:\r\n%\r\n% <<https:\/\/blogs.mathworks.com\/images\/steve\/2015\/repelem-doc-screenshot-4.png>>\r\n%\r\n% You can see that |repelem| is new in R2015a! Customers have long been\r\n% asking us to provide this information on function reference pages. (Please\r\n% note that the \"introduced in\" information is not available for all\r\n% functions yet. It will take us some time to update every page.)\r\n%\r\n% Finally, the new document system displays reference pages and other\r\n% content very nicely on mobile devices. Here is a screenshot from my\r\n% phone:\r\n%\r\n% <<https:\/\/blogs.mathworks.com\/images\/steve\/2015\/repelem-doc-screenshot-phone.png>>\r\n%\r\n% We'd like to know what you think about the new online doc. That would\r\n% help our teams as they bring these updates to the documentation system\r\n% that's included with the product. If you have any feedback you'd like to\r\n% share, please leave a comment below.\r\n##### SOURCE END ##### 5a00c9cdc9ab42fbadd836f1799dbcd0\r\n-->","protected":false},"excerpt":{"rendered":"<div class=\"overview-image\"><img decoding=\"async\"  class=\"img-responsive\" src=\"https:\/\/blogs.mathworks.com\/images\/steve\/2015\/repelem-doc-screenshot-1.png\" onError=\"this.style.display ='none';\" \/><\/div><p>Earlier this month we shipped R2015a, the first of our two regularly scheduled annual releases. Typically, when there's a new release, I spend some time talking about features that interest me. The... <a class=\"read-more\" href=\"https:\/\/blogs.mathworks.com\/steve\/2015\/03\/25\/new-online-documentation-system-for-r2015a\/\">read more >><\/a><\/p>","protected":false},"author":42,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[1107],"_links":{"self":[{"href":"https:\/\/blogs.mathworks.com\/steve\/wp-json\/wp\/v2\/posts\/1307"}],"collection":[{"href":"https:\/\/blogs.mathworks.com\/steve\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blogs.mathworks.com\/steve\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blogs.mathworks.com\/steve\/wp-json\/wp\/v2\/users\/42"}],"replies":[{"embeddable":true,"href":"https:\/\/blogs.mathworks.com\/steve\/wp-json\/wp\/v2\/comments?post=1307"}],"version-history":[{"count":2,"href":"https:\/\/blogs.mathworks.com\/steve\/wp-json\/wp\/v2\/posts\/1307\/revisions"}],"predecessor-version":[{"id":1309,"href":"https:\/\/blogs.mathworks.com\/steve\/wp-json\/wp\/v2\/posts\/1307\/revisions\/1309"}],"wp:attachment":[{"href":"https:\/\/blogs.mathworks.com\/steve\/wp-json\/wp\/v2\/media?parent=1307"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blogs.mathworks.com\/steve\/wp-json\/wp\/v2\/categories?post=1307"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blogs.mathworks.com\/steve\/wp-json\/wp\/v2\/tags?post=1307"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}