Merge branch 'release/v1.3'

Author: yannduran

developer-news.sln

@@ -54,7 +54,10 @@ EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "2. changes", "2. changes", "{2C4A9B8A-C4DE-4854-A698-CB4D465BAF0A}"
 	ProjectSection(SolutionItems) = preProject
 		docs-source\changelog.md = docs-source\changelog.md
+		docs-source\assets\images\dev-news.png = docs-source\assets\images\dev-news.png
 		docs-source\features.md = docs-source\features.md
+		docs-source\assets\images\general-options.png = docs-source\assets\images\general-options.png
+		docs-source\assets\images\installer.png = docs-source\assets\images\installer.png
 		docs-source\roadmap.md = docs-source\roadmap.md
 	EndProjectSection
 EndProject

docs-source/assets/images/dev-news.png

@@ -1,7 +1,14 @@
 ## Public Releases
 
+### v1.3 - 2020-04-19
+- added option to change the feed url
+- added option to change the number of items displayed
+- added option to supress clearing the list before refreshing
+- added an 'Options' command to open Tools | Options | General in one click
+
 ### v1.2 - 2020-04-10
-- use selected theme's colors/font sizes (as in Start Page+)
+- added selected theme support (same as in Start Page+)
+- removed 'View More News' command
 
 ### v1.1 - 2019-07-01
 - added option to open links in default browser

docs-source/assets/images/general-options.png

@@ -4,17 +4,10 @@ To display the new *Developer News* window:
 
 ## Dev News Feed
 
-The _Dev News_ feed is based on the feed from the Developer News control on the old VS 2017 startup page.
-It's the first feed that has been added to the new _Developer News_ window.
+The _Dev News_ feed is based on the feed from the _Developer News_ control on the old VS 2017 startup page.
 
 ![Dev News](assets/images/dev-news.png)
 
-## Other Feeds
-
-Other feeds will follow in the near future. Check out the [Roadmap][roadmap-url] for more details.
-
-[roadmap-url]: https://luminous-software.solutions/developer-news/roadmap
-
 ## Options
 
 ![General Options](assets/images/general-options.png)
@@ -27,9 +20,36 @@ This setting allows the whole set of _Developer News_ features to be turned off
 
 Displays then version number of _Developer News_ that's currently installed.
 
+### Enable 'Clear list before refresh'
+
+The default value is `true`, which means that the list will be cleared before a refresh is performed.
+This gives a visual indication that the list is being refreshed.
+
+A value of `false` may mean that the list refreshes so fast that it's not obvious that it was in fact refreshed.
+
+### Enable 'Developer News Options'
+
+The default value is `true`, which adds a 'Developer News Options' command to be added to the `Tools` | `Options` menu.
+
 ### Enable 'Open Links in VS'
 
 The default value is `true`, meaning that any item link that is clicked will be opened in a window
 inside of Visual Studio.
 
-A value of `false` will result in the link being opened in your default browser.
+A value of `false` will result in the link being opened in your default browser.
+
+### Feed Url
+
+This setting allows the list to be populated from an RSS feed other than that of VS 2017's _Developer News_.
+
+The default value is https://vsstartpage.blob.core.windows.net/news/vs.
+
+### Number of Items to display
+
+This allows you to limit the number of items displayed in the list.
+
+The default value is `10`. This is how many items that Microsoft currently maintains in the default feed.
+Only the newest three get displayed in the Installer's _Developer News_ section even though it points to the same source.
+
+A value greater than `10` will still only display ten items. A value of `0` will currently display zero items,
+but this may in the future be changed to indicate that all items in the feed should be displayed.

docs-source/changelog.md

@@ -5,9 +5,6 @@ These might be entirely **new features** or **enhancements** to existing feature
 
 They may, or may not, end up being added into _Developer News_.
 
-- [ ] Visual Studio Blog feed
-- [ ] Visual Studio Twitter feed
-- [ ] Azure DevOps Blog feed
 - [ ] Auto-refresh
 
 Ticked items are available in the lastest version of _Developer News_.

docs-source/features.md

@@ -235,6 +235,13 @@
     <nav class="md-nav">
       <ul class="md-nav__list">
 
+          <li class="md-nav__item">
+  <a href="#v13-2020-04-19" title="v1.3 - 2020-04-19" class="md-nav__link">
+    v1.3 - 2020-04-19
+  </a>
+  
+</li>
+        
           <li class="md-nav__item">
   <a href="#v12-2020-04-10" title="v1.2 - 2020-04-10" class="md-nav__link">
     v1.2 - 2020-04-10
@@ -342,6 +349,13 @@
     <nav class="md-nav">
       <ul class="md-nav__list">
 
+          <li class="md-nav__item">
+  <a href="#v13-2020-04-19" title="v1.3 - 2020-04-19" class="md-nav__link">
+    v1.3 - 2020-04-19
+  </a>
+  
+</li>
+        
           <li class="md-nav__item">
   <a href="#v12-2020-04-10" title="v1.2 - 2020-04-10" class="md-nav__link">
     v1.2 - 2020-04-10
@@ -420,9 +434,17 @@
                   <h1>Changelog</h1>
 
                 <h2 id="public-releases">Public Releases<a class="headerlink" href="#public-releases" title="Permanent link">&para;</a></h2>
+<h3 id="v13-2020-04-19">v1.3 - 2020-04-19<a class="headerlink" href="#v13-2020-04-19" title="Permanent link">&para;</a></h3>
+<ul>
+<li>added option to change the feed url</li>
+<li>added option to change the number of items displayed</li>
+<li>added option to supress clearing the list before refreshing</li>
+<li>added an 'Options' command to open Tools | Options | General in one click</li>
+</ul>
 <h3 id="v12-2020-04-10">v1.2 - 2020-04-10<a class="headerlink" href="#v12-2020-04-10" title="Permanent link">&para;</a></h3>
 <ul>
-<li>use selected theme's colors/font sizes (as in Start Page+)</li>
+<li>added selected theme support (same as in Start Page+)</li>
+<li>removed 'View More News' command</li>
 </ul>
 <h3 id="v11-2019-07-01">v1.1 - 2019-07-01<a class="headerlink" href="#v11-2019-07-01" title="Permanent link">&para;</a></h3>
 <ul>

docs-source/roadmap.md

@@ -220,13 +220,6 @@
     Dev News Feed
   </a>
 
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#other-feeds" title="Other Feeds" class="md-nav__link">
-    Other Feeds
-  </a>
-  
 </li>
 
         <li class="md-nav__item">
@@ -249,13 +242,41 @@
     Version Number
   </a>
 
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#enable-clear-list-before-refresh" title="Enable 'Clear list before refresh'" class="md-nav__link">
+    Enable 'Clear list before refresh'
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#enable-developer-news-options" title="Enable 'Developer News Options'" class="md-nav__link">
+    Enable 'Developer News Options'
+  </a>
+  
 </li>
 
           <li class="md-nav__item">
   <a href="#enable-open-links-in-vs" title="Enable 'Open Links in VS'" class="md-nav__link">
     Enable 'Open Links in VS'
   </a>
 
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#feed-url" title="Feed Url" class="md-nav__link">
+    Feed Url
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#number-of-items-to-display" title="Number of Items to display" class="md-nav__link">
+    Number of Items to display
+  </a>
+  
 </li>
 
       </ul>
@@ -319,13 +340,6 @@
     Dev News Feed
   </a>
 
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#other-feeds" title="Other Feeds" class="md-nav__link">
-    Other Feeds
-  </a>
-  
 </li>
 
         <li class="md-nav__item">
@@ -348,13 +362,41 @@
     Version Number
   </a>
 
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#enable-clear-list-before-refresh" title="Enable 'Clear list before refresh'" class="md-nav__link">
+    Enable 'Clear list before refresh'
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#enable-developer-news-options" title="Enable 'Developer News Options'" class="md-nav__link">
+    Enable 'Developer News Options'
+  </a>
+  
 </li>
 
           <li class="md-nav__item">
   <a href="#enable-open-links-in-vs" title="Enable 'Open Links in VS'" class="md-nav__link">
     Enable 'Open Links in VS'
   </a>
 
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#feed-url" title="Feed Url" class="md-nav__link">
+    Feed Url
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#number-of-items-to-display" title="Number of Items to display" class="md-nav__link">
+    Number of Items to display
+  </a>
+  
 </li>
 
       </ul>
@@ -384,21 +426,33 @@ <h1>Features</h1>
 <li>click <strong>View</strong> | <strong>Developer News</strong></li>
 </ul>
 <h2 id="dev-news-feed">Dev News Feed<a class="headerlink" href="#dev-news-feed" title="Permanent link">&para;</a></h2>
-<p>The <em>Dev News</em> feed is based on the feed from the Developer News control on the old VS 2017 startup page.
-It's the first feed that has been added to the new <em>Developer News</em> window.</p>
+<p>The <em>Dev News</em> feed is based on the feed from the <em>Developer News</em> control on the old VS 2017 startup page.</p>
 <p><img alt="Dev News" src="../assets/images/dev-news.png" /></p>
-<h2 id="other-feeds">Other Feeds<a class="headerlink" href="#other-feeds" title="Permanent link">&para;</a></h2>
-<p>Other feeds will follow in the near future. Check out the <a href="https://luminous-software.solutions/developer-news/roadmap">Roadmap</a> for more details.</p>
 <h2 id="options">Options<a class="headerlink" href="#options" title="Permanent link">&para;</a></h2>
 <p><img alt="General Options" src="../assets/images/general-options.png" /></p>
 <h3 id="enable-developer-news">Enable 'Developer News'<a class="headerlink" href="#enable-developer-news" title="Permanent link">&para;</a></h3>
 <p>This setting allows the whole set of <em>Developer News</em> features to be turned off together.</p>
 <h3 id="version-number">Version Number<a class="headerlink" href="#version-number" title="Permanent link">&para;</a></h3>
 <p>Displays then version number of <em>Developer News</em> that's currently installed.</p>
+<h3 id="enable-clear-list-before-refresh">Enable 'Clear list before refresh'<a class="headerlink" href="#enable-clear-list-before-refresh" title="Permanent link">&para;</a></h3>
+<p>The default value is <code>true</code>, which means that the list will be cleared before a refresh is performed.
+This gives a visual indication that the list is being refreshed.</p>
+<p>A value of <code>false</code> may mean that the list refreshes so fast that it's not obvious that it was in fact refreshed.</p>
+<h3 id="enable-developer-news-options">Enable 'Developer News Options'<a class="headerlink" href="#enable-developer-news-options" title="Permanent link">&para;</a></h3>
+<p>The default value is <code>true</code>, which adds a 'Developer News Options' command to be added to the <code>Tools</code> | <code>Options</code> menu.</p>
 <h3 id="enable-open-links-in-vs">Enable 'Open Links in VS'<a class="headerlink" href="#enable-open-links-in-vs" title="Permanent link">&para;</a></h3>
 <p>The default value is <code>true</code>, meaning that any item link that is clicked will be opened in a window
 inside of Visual Studio.</p>
 <p>A value of <code>false</code> will result in the link being opened in your default browser.</p>
+<h3 id="feed-url">Feed Url<a class="headerlink" href="#feed-url" title="Permanent link">&para;</a></h3>
+<p>This setting allows the list to be populated from an RSS feed other than that of VS 2017's <em>Developer News</em>.</p>
+<p>The default value is <a href="https://vsstartpage.blob.core.windows.net/news/vs">https://vsstartpage.blob.core.windows.net/news/vs</a>.</p>
+<h3 id="number-of-items-to-display">Number of Items to display<a class="headerlink" href="#number-of-items-to-display" title="Permanent link">&para;</a></h3>
+<p>This allows you to limit the number of items displayed in the list.</p>
+<p>The default value is <code>10</code>. This is how many items that Microsoft currently maintains in the default feed.
+Only the newest three get displayed in the Installer's <em>Developer News</em> section even though it points to the same source.</p>
+<p>A value greater than <code>10</code> will still only display ten items. A value of <code>0</code> will currently display zero items,
+but this may in the future be changed to indicate that all items in the feed should be displayed.</p>