Remove+redirect framework/deployment docs to /install with updates #1979

guardrex · 2017-04-21T04:42:28Z

Remove+redirect framework/deployment docs
Minor grammar+style updates
Fix layout (remove stray spaces, fix tables, etc.)

Updates

mairaw · 2017-04-27T07:31:50Z

We also need an entry from the main TOC to the Installation Guide.

mairaw

This looks great! left a few comments in addition to the main TOC request I made earlier.

mairaw · 2017-04-27T07:34:44Z

docs/framework/install/index.md

 ## Unsupported Windows versions

- [Windows XP](on-windows-xp.md)
+- [Windows XP](on-windows-xp.md)


Since now this is the main entrance to installation, it also needs to be changed to point to the for developers guide. I'd also remove the intro and the first sub-header, since they don't seem to add much value.

mairaw · 2017-04-27T07:36:22Z

docs/framework/install/toc.md

+## [Running .NET Framework 1.1 Apps on Windows 8, Windows 8.1, or Windows 10](run-net-framework-1-1-apps.md)
+## [Install the .NET Framework 3.5 on Windows 10, Windows 8.1, and Windows 8](dotnet-35-windows-10.md)
+## [Troubleshooting the installation of the .NET Framework 3.5 on Windows 8, Windows 8.1, and Windows 10](net-framework-3-5-on-windows-8-plus.md)
+## [Installing the .NET Framework](guide-for-developers.md)


remove ing from the titles (general comment, not just here). In this particular case, the title should be changed to something different since the index.md file is now the Installing the .NET Framework topic

@mairaw Rename Installing the .NET Framework (guide-for-developers.md) 👉 Install the .NET Framework for developers?

mairaw · 2017-04-27T07:37:50Z

docs/framework/install/toc.md

+## [Install the .NET Framework 3.5 on Windows 10, Windows 8.1, and Windows 8](dotnet-35-windows-10.md)
+## [Troubleshooting the installation of the .NET Framework 3.5 on Windows 8, Windows 8.1, and Windows 10](net-framework-3-5-on-windows-8-plus.md)
+## [Installing the .NET Framework](guide-for-developers.md)
+## [Installing the .NET Framework on Windows 10](on-windows-10.md)


I'd move these topics to the top of the TOC

mairaw · 2017-04-27T07:38:14Z

docs/framework/install/toc.md

-## [Installing the .NET Framework 3.5 on Windows 8 and later versions](net-framework-3-5-on-windows-8-plus.md)
-## [Running .NET Framework 1.1 Apps on Windows 8 and later versions](run-net-framework-1-1-apps.md)
-## [Troubleshooting](troubleshoot-blocked-installations-and-uninstallations.md)
+## [Running .NET Framework 1.1 Apps on Windows 8, Windows 8.1, or Windows 10](run-net-framework-1-1-apps.md)


should be the last entry

mairaw · 2017-04-27T07:38:25Z

docs/framework/install/toc.md

-## [Troubleshooting](troubleshoot-blocked-installations-and-uninstallations.md)
+## [Running .NET Framework 1.1 Apps on Windows 8, Windows 8.1, or Windows 10](run-net-framework-1-1-apps.md)
+## [Install the .NET Framework 3.5 on Windows 10, Windows 8.1, and Windows 8](dotnet-35-windows-10.md)
+## [Troubleshooting the installation of the .NET Framework 3.5 on Windows 8, Windows 8.1, and Windows 10](net-framework-3-5-on-windows-8-plus.md)


make it a child of install

mairaw · 2017-04-27T07:41:25Z

toc.yml

        tocHref: /dotnet/articles/framework/deployment/
        topicHref: /dotnet/articles/framework/deployment/index
-        items:
-        - name: Installing the .NET Framework on Windows


on the same entry for the install folder, we should change this to Installation Guide

mairaw · 2017-04-27T07:44:49Z

docs/framework/install/net-framework-3-5-on-windows-8-plus.md

+
+# Troubleshooting the installation of the .NET Framework 3.5 on Windows 8, Windows 8.1, and Windows 10
+
+During installation you may encounter error 0x800f0906, 0x800f0907, or 0x800f081f, in which case refer to [.NET Framework 3.5 installation error: 0x800f0906, 0x800f0907, or 0x800f081f](https://support.microsoft.com/en-us/kb/2734782). Note that these are possibly resolved by installing [security update 3005628](https://support.microsoft.com/kb/3005628).


the link to the kb article 2734782 is not what i expected. i think we need to link to https://support.microsoft.com/en-us/help/2734782/.net-framework-3.5-installation-error-0x800f0906,-0x800f081f,-0x800f0907.

mairaw · 2017-04-27T07:46:28Z

docs/framework/install/net-framework-3-5-on-windows-8-plus.md

+
+During installation you may encounter error 0x800f0906, 0x800f0907, or 0x800f081f, in which case refer to [.NET Framework 3.5 installation error: 0x800f0906, 0x800f0907, or 0x800f081f](https://support.microsoft.com/en-us/kb/2734782). Note that these are possibly resolved by installing [security update 3005628](https://support.microsoft.com/kb/3005628).
+
+If the installation fails or you don't have an Internet connection, it's necessary to use your Windows installation media. For details, see Method 3 for error 0x800f0906 in the [.NET Framework 3.5 installation error article](https://support.microsoft.com/en-us/kb/2734782). If you don't have installation media, see [Create Installation media for Windows 8.1](http://windows.microsoft.com/en-US/windows-8/create-reset-refresh-media?woldogcb=0).


same here for kb article.

guardrex · 2017-04-28T01:34:38Z

@mairaw The last set of changes is extensive in attempting to realign link titles with changed doc names (e.g., dropping "-ing" and changing "Installation Guide" where it pointed to the guide for developers). I've temporarily used the title Install the .NET Framework for developers for the guide-for-developers.md doc until you let me know what you'd like to call that one.

mairaw

There also needs to be an entry for the Installation Guide from the main TOC under framework.

mairaw · 2017-05-04T08:15:30Z

docs/framework/get-started/index.md

 |[.NET Core and Open-Source](../../../docs/framework/get-started/net-core-and-open-source.md)|Describes what .NET Core is in relation to the .NET Framework and how to access the open-source .NET Core projects.|  
 |[.NET Core documentation](https://docs.microsoft.com/dotnet/)|The conceptual and API reference documentation for .NET Core.|  
-|[Installation Guide](../../../docs/framework/install/guide-for-developers.md)|Provides information about installing the .NET Framework.|  
+|[Install the .NET Framework for developers](../../../docs/framework/install/guide-for-developers.md)|Provides information about installing the .NET Framework.|  


maybe change this to point to the new installation guide (index.md)

mairaw · 2017-05-04T08:16:46Z

docs/framework/get-started/index.md

+|[Install the .NET Framework for developers](../../../docs/framework/install/guide-for-developers.md)|Provides information about installing the .NET Framework.|  

 ## See Also  
 [.NET Framework 4.6 and 4.5](../../../docs/framework/index.md)   


maybe for another PR but this string (.NET Framework 4.6 and 4.5) should be removed from the docs - I've seen it a few times. We should now call it .NET Framework Guide IMO.

Opened for work at #2094

mairaw · 2017-05-04T08:17:31Z

docs/framework/get-started/overview.md


 > [!NOTE]
->  For a general introduction to the .NET Framework for both users and developers, see [Getting Started](../../../docs/framework/get-started/index.md). To download the .NET Framework, see [Installation Guide](../../../docs/framework/install/guide-for-developers.md).  
+>  For a general introduction to the .NET Framework for both users and developers, see [Getting Started](../../../docs/framework/get-started/index.md). To download the .NET Framework, see [Install the .NET Framework for developers](../../../docs/framework/install/guide-for-developers.md).  


same here - change the link to the index file instead of changing the link text

mairaw · 2017-05-04T08:37:31Z

docs/framework/get-started/system-requirements.md

 The tables in this topic provide the hardware, operating system, and software requirements for the .NET Framework 4.5 and its point releases (4.5.1 and 4.5.2), the [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] and its point releases (4.6.1 and 4.6.2), and the .NET Framework 4.7. Development environments that enable you to develop applications for the .NET Framework have a separate set of requirements.  

- For download information and links, see [Installation Guide](../../../docs/framework/install/guide-for-developers.md).  
+ For download information and links, see [Install the .NET Framework for developers](../../../docs/framework/install/guide-for-developers.md).  


again, change link to index.md instead of changing link text. review where you made this change to see whether it makes sense to go to the developer's one or the general one

These preexisted the PR pointing to guide-for-developers.md, which is why I didn't consider changing them (i.e., I trusted the author of the topic). I'll search and take a closer 👀 look at where the guide for devs is linked.

[EDIT] Took a look. I removed one link to the dev version where the getting started index page is linked. The getting started index page delineates user vs. dev info and links, so that link to the guide for developers wasn't necessary. Otherwise, the other topics look dev-ish in nature.

mairaw · 2017-05-04T08:47:30Z

@richlander @rpetrusha with the release of .NET 4.7, do we need to make updates to the new Windows install pages to include 4.7?
Also, the link used https://go.microsoft.com/fwlink/?linkid=845529&source=dotnetdocs takes you to https://www.microsoft.com/net? Should that instead take you to https://www.microsoft.com/net/download/framework?

mairaw

Thanks @guardrex! It will be important to get this one merged. This set is probably due now for another update with the release of .NET Framework 4.7, but let's address that on a separate PR. I've made a few fixes to the TOC structure.

guardrex · 2017-05-18T13:59:48Z

Update framework/deployment topics for 4.7 issue created.

mairaw · 2017-05-18T17:57:46Z

We only change the ms.date if we made sure that the actual content of the topic is accurate and relevant. I don't think that's the case in this particular PR given that we haven't added 4.7, for example.

guardrex · 2017-05-18T17:58:15Z

ok ... I'll revert those.

Initial commit

e1df551

Updates

guardrex self-assigned this Apr 21, 2017

dnfclas added the cla-already-signed label Apr 21, 2017

guardrex closed this Apr 21, 2017

guardrex reopened this Apr 21, 2017

dnfclas added the cla-already-signed label Apr 21, 2017

mairaw requested changes Apr 27, 2017

View reviewed changes

Luke Latham added 3 commits April 27, 2017 17:11

Updates

0081cd4

Updates

205aac6

React to feedback

fa1f8d6

guardrex closed this Apr 28, 2017

guardrex reopened this Apr 28, 2017

dnfclas added the cla-already-signed label Apr 28, 2017

guardrex closed this May 1, 2017

guardrex reopened this May 1, 2017

dnfclas added the cla-already-signed label May 1, 2017

Merge branch 'master' into guardrex/install-updates

23b1b84

mairaw requested changes May 4, 2017

View reviewed changes

guardrex mentioned this pull request May 4, 2017

Change doc title #2094

Closed

Luke Latham and others added 8 commits May 4, 2017 13:35

React to feedback

f05fecc

Merge branch 'master' into guardrex/install-updates

7c8ba1e

Merge branch 'master' into guardrex/install-updates

d9289f8

Merge branch 'master' into guardrex/install-updates

22911db

Merge branch 'master' into guardrex/install-updates

25f0002

changed entries order

c6ed6bc

fixed TOC

6ffba54

added installation guide entry

3a89bf8

fixed link

bc02fe5

mairaw approved these changes May 18, 2017

View reviewed changes

mairaw added the verify-build-before-merge label May 18, 2017

Fix bookmark and update dates

99599a3

guardrex mentioned this pull request May 18, 2017

Update framework/deployment topics for 4.7 #2196

Closed

Revert dates

7ac92b4

guardrex added merge-on-hold-for-live-update and removed merge-on-hold-for-live-update labels May 18, 2017

guardrex closed this May 18, 2017

guardrex reopened this May 18, 2017

dnfclas added the cla-already-signed label May 18, 2017

guardrex removed the verify-build-before-merge label May 19, 2017

guardrex merged commit fe9ab37 into dotnet:master May 19, 2017

guardrex deleted the guardrex/install-updates branch May 19, 2017 17:45


		# Troubleshooting the installation of the .NET Framework 3.5 on Windows 8, Windows 8.1, and Windows 10

		During installation you may encounter error 0x800f0906, 0x800f0907, or 0x800f081f, in which case refer to [.NET Framework 3.5 installation error: 0x800f0906, 0x800f0907, or 0x800f081f](https://support.microsoft.com/en-us/kb/2734782). Note that these are possibly resolved by installing [security update 3005628](https://support.microsoft.com/kb/3005628).


		During installation you may encounter error 0x800f0906, 0x800f0907, or 0x800f081f, in which case refer to [.NET Framework 3.5 installation error: 0x800f0906, 0x800f0907, or 0x800f081f](https://support.microsoft.com/en-us/kb/2734782). Note that these are possibly resolved by installing [security update 3005628](https://support.microsoft.com/kb/3005628).

		If the installation fails or you don't have an Internet connection, it's necessary to use your Windows installation media. For details, see Method 3 for error 0x800f0906 in the [.NET Framework 3.5 installation error article](https://support.microsoft.com/en-us/kb/2734782). If you don't have installation media, see [Create Installation media for Windows 8.1](http://windows.microsoft.com/en-US/windows-8/create-reset-refresh-media?woldogcb=0).

Remove+redirect framework/deployment docs to /install with updates #1979

Remove+redirect framework/deployment docs to /install with updates #1979

Uh oh!

Conversation

guardrex commented Apr 21, 2017

Uh oh!

mairaw commented Apr 27, 2017

Uh oh!

mairaw left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

guardrex commented Apr 28, 2017

Uh oh!

mairaw left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

guardrex May 4, 2017 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mairaw commented May 4, 2017

Uh oh!

mairaw left a comment

Choose a reason for hiding this comment

Uh oh!

guardrex commented May 18, 2017

Uh oh!

mairaw commented May 18, 2017

Uh oh!

guardrex commented May 18, 2017

Uh oh!

Uh oh!

guardrex May 4, 2017 •

edited

Loading