Improve Network's descriptions

[anton-evseev]

Latest improvements:

MSFT employees can try out our new experience at OpenAPI Hub - one location for using our validation tools and finding your workflow.

Contribution checklist:

• I have reviewed the documentation for the workflow.
• Validation tools were run on swagger spec(s) and have all been fixed in this PR.
• The OpenAPI Hub was used for checking validation status and next steps.

ARM API Review Checklist

• Service team MUST add the "WaitForARMFeedback" label if the management plane API changes fall into one of the below categories.
• adding/removing APIs.
• adding/removing properties.
• adding/removing API-version.
• adding a new service in Azure.

Failure to comply may result in delays for manifest application. Note this does not apply to data plane APIs.

• If you are blocked on ARM review and want to get the PR merged urgently, please get the ARM oncall for reviews (RP Manifest Approvers team under Azure Resource Manager service) from IcM and reach out to them.
  Please follow the link to find more details on API review process.

[openapi-sdkautomation]

In Testing, Please Ignore

[Logs] (Generated from a288e76, Iteration 4)

.NET: test-repo-billy/azure-sdk-for-net

• Package generation pending.

Python: test-repo-billy/azure-sdk-for-python [Logs]

• Package generation in progress.

Java: test-repo-billy/azure-sdk-for-java

• Package generation pending.

Go: test-repo-billy/azure-sdk-for-go [Logs]

• Package generation in progress.

JavaScript: test-repo-billy/azure-sdk-for-js

• Package generation pending.

Ruby: test-repo-billy/azure-sdk-for-ruby

• Package generation pending.

[AutorestCI]

Automation for azure-sdk-for-python

Encountered a Subprocess error: (azure-sdk-for-python)

Command: ['/usr/local/bin/autorest', '/tmp/tmpbo0h6nhs/rest/specification/network/resource-manager/readme.md', '--keep-version-file', '--multiapi', '--no-async', '--python', '--python-mode=update', '--python-sdks-folder=/tmp/tmpbo0h6nhs/sdk/sdk', '--use=@microsoft.azure/autorest.python@4.0.70', '--version=preview']
Finished with return code -6
and output:

AutoRest code generation utility [version: 2.0.4283; node: v10.15.3]
(C) 2018 Microsoft Corporation.
https://aka.ms/autorest
   Loading AutoRest core      '/root/.autorest/@microsoft.azure_autorest-core@2.0.4390/node_modules/@microsoft.azure/autorest-core/dist' (2.0.4390)
   Loading AutoRest extension '@microsoft.azure/autorest.python' (4.0.70->4.0.70)
   Loading AutoRest extension '@microsoft.azure/autorest.modeler' (2.3.44->2.3.44)
Processing batch task - {"tag":"package-2019-06"} .

<--- Last few GCs --->

[6771:0x2ba7cc0]    95948 ms: Mark-sweep 1378.5 (1427.1) -> 1378.5 (1427.6) MB, 3005.8 / 0.0 ms  (average mu = 0.093, current mu = 0.001) allocation failure GC in old space requested
[6771:0x2ba7cc0]    98361 ms: Mark-sweep 1378.7 (1427.6) -> 1378.7 (1428.1) MB, 2412.1 / 0.0 ms  (average mu = 0.051, current mu = 0.001) allocation failure GC in old space requested


<--- JS stacktrace --->

==== JS stack trace =========================================

    0: ExitFrame [pc: 0x291e997dbe1d]
Security context: 0x1816f799e6e9 <JSObject>
    1: newScalar [0x1e0e60989009] [/node_modules/yaml-ast-parser/dist/src/yamlAST.js:~38] [pc=0x291e99cf27b6](this=0x1e0e609da371 <Object map = 0x39e70faaa7e9>,v=0x33fc60b026f1 <undefined>)
    2: arguments adaptor frame: 0->1
    3: readDoubleQuotedScalar(aka readDoubleQuotedScalar) [0x1e0e609dac71] [/node_modules/yaml-ast-parser/dist/src/loader.js:~530] [p...

FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory
 1: 0x8dc510 node::Abort() [node]
 2: 0x8dc55c  [node]
 3: 0xad9b5e v8::Utils::ReportOOMFailure(v8::internal::Isolate*, char const*, bool) [node]
 4: 0xad9d94 v8::internal::V8::FatalProcessOutOfMemory(v8::internal::Isolate*, char const*, bool) [node]
 5: 0xec7bf2  [node]
 6: 0xec7cf8 v8::internal::Heap::CheckIneffectiveMarkCompact(unsigned long, double) [node]
 7: 0xed3dd2 v8::internal::Heap::PerformGarbageCollection(v8::internal::GarbageCollector, v8::GCCallbackFlags) [node]
 8: 0xed4704 v8::internal::Heap::CollectGarbage(v8::internal::AllocationSpace, v8::internal::GarbageCollectionReason, v8::GCCallbackFlags) [node]
 9: 0xed7371 v8::internal::Heap::AllocateRawWithRetryOrFail(int, v8::internal::AllocationSpace, v8::internal::AllocationAlignment) [node]
10: 0xea07f4 v8::internal::Factory::NewFillerObject(int, bool, v8::internal::AllocationSpace) [node]
11: 0x11402db v8::internal::Runtime_AllocateInTargetSpace(int, v8::internal::Object**, v8::internal::Isolate*) [node]
12: 0x291e997dbe1d

[azuresdkci]

Can one of the admins verify this patch?

[AutorestCI]

Automation for azure-sdk-for-go

A PR has been created for you:
Azure/azure-sdk-for-go#5584

[anton-evseev]

@zikalino SDK java job time'd out due to 2 hour limit, otherwise CI looks good

[anton-evseev]

I've amended/rebase this PR to target 2019-07-01. @zikalino could you please take a look?