Update warnings for experimental features in documentation

[azcloudfarmer]

Clarify warnings regarding experimental features in Bicep.

Description

Example Usage

Checklist

• I have read and adhere to the contribution guide.

Microsoft Reviewers: Open in CodeFlow

[github-actions]

Test this change out locally with the following install scripts (Action run 19868401663)

VSCode

• Mac/Linux

  bash <(curl -Ls https://aka.ms/bicep/nightly-vsix.sh) --run-id 19868401663

• Windows

  iex "& { $(irm https://aka.ms/bicep/nightly-vsix.ps1) } -RunId 19868401663"

Azure CLI

• Mac/Linux

  bash <(curl -Ls https://aka.ms/bicep/nightly-cli.sh) --run-id 19868401663

• Windows

  iex "& { $(irm https://aka.ms/bicep/nightly-cli.ps1) } -RunId 19868401663"

[github-actions]

Dotnet Test Results

   102 files   -     51     102 suites   - 51   39m 59s ⏱️ - 18m 14s
12 567 tests  -     13  12 567 ✅  -     13  0 💤 ±0  0 ❌ ±0 
28 879 runs   - 14 433  28 879 ✅  - 14 433  0 💤 ±0  0 ❌ ±0 

Results for commit 54d4a9b. ± Comparison against base commit c903597.

This pull request removes 1954 and adds 661 tests. Note that renamed tests count towards both.

		nestedProp1: 1
		nestedProp2: 2
		prop1: true
		prop2: false
	,�\u0008ں�\u0015 �<	�\u001e��l�2�����\�+V4yA\u001ba���hL����t��:nԳ��a0��/\u0015\u0008-�\u0014ZZ4���\u0013����v�����PRxЩ�lGő�d���V�k�lQ\u0014E\u0011\u000c�
��\u001d�\u0000\u000c\u0000\u0000,"Value cannot be null. (Parameter 'source')")
	1
	2
	\$'")
	prop1: true
…

Bicep.Cli.UnitTests.Services.ReplEnvironmentTests ‑ ShouldSubmitBuffer_terminates_at_expected_point ("var foo = {
")
Bicep.Cli.UnitTests.Services.ReplEnvironmentTests ‑ ShouldSubmitBuffer_terminates_at_expected_point ("var multilineString = '''
Line 1
Line 2
Line 3
'''")
Bicep.Cli.UnitTests.Services.ReplEnvironmentTests ‑ ShouldSubmitBuffer_terminates_at_expected_point ("var outRoleAssignments object[] = union(map(
  filter(varMockedEntraGroupIds, item => !contains(item.uniqueName, 'DevOps')),
  group => {
    principalId: group.groupId
    definition: group.roleToAssign
    relativeScope: ''
    principalType: 'Group'
  }
),[
  {
    principalId: '22222222-2222-2222-2222-222222222222'
    definition: 'Reader'
    relativeScope: ''
    principalType: 'ServicePrincipal'
  }
])")
Bicep.Cli.UnitTests.Services.ReplEnvironmentTests ‑ ShouldSubmitBuffer_terminates_at_expected_point ("var test = {
  abc: 'def' // boo
}")
Bicep.Cli.UnitTests.Services.ReplEnvironmentTests ‑ ShouldSubmitBuffer_terminates_at_expected_point ("var varMockedEntraGroupIds = [
  {
    uniqueName: 'Reader-Group'
    roleToAssign: 'Reader'
    groupId: '11111111-1111-1111-1111-111111111111'
  }
  {
    uniqueName: 'Contributor-Group'
    roleToAssign: 'Contributor'
    groupId: '22222222-2222-2222-2222-222222222222'
  }
  {
    uniqueName: 'DevOps-Group'
    groupId: '33333333-3333-3333-3333-333333333333'
  }
]")
Bicep.Core.IntegrationTests.AzTypesViaRegistryTests ‑ Bicep_compiler_handles_corrupted_extension_package_gracefully (\u001f�\u0008\u0000\u0000\u0000\u0000\u0000\u0000
�ӱ
�@\u0010\u0004�\u0015�\u001fp�%��EH!X��
��\u0004\u00120BT�\u0008\u0001�^�\u0011��$Zx��f��e�x���<�������\u0001\u0000[�J\u0000�\u0004&ܹ\u0017\u0001H��\u0005��I+\u0002�?�X���\u0014�,o���^�PT�\u0014e�\u0018a˱��i��:\u000e~������4���\u000f-��1\u0011�֚�`\u0000\u0018R_������\u0018-7��z9?����h�D�ם<��<\u001a�\u0013�\u001e\u0002�\u0000\u000c\u0000\u0000,"'7' is an invalid end of a number. Expected a delimiter. Path: $.INVALID_JSON | LineNumber: 0 | BytePositionInLine: 20.")
Bicep.Core.IntegrationTests.AzTypesViaRegistryTests ‑ Bicep_compiler_handles_corrupted_extension_package_gracefully (\u001f�\u0008\u0000\u0000\u0000\u0000\u0000\u0000
��=
�@\u0010\u0005�=Ş`}�����>e��\u0010!?���D\u0008�{ U�Ic�p��5S<\u0018��\u000fa���X�;�D�k�\u001b\u0000���\u00040M@xr��YR#-`��p'��ɰ���T
�\u001a�Gԗ������M]�\u0013+;_8��x�첵\u000b'���;�����\u0010�̅\u0018k�\u0010\u0018���\u0016����?_k7H�$Ih\u0005o/t��\u0000\u000c\u0000\u0000,"The path: index.json was not found in artifact contents")
Bicep.Core.IntegrationTests.AzTypesViaRegistryTests ‑ Bicep_compiler_handles_corrupted_extension_package_gracefully (\u001f�\u0008\u0000\u0000\u0000\u0000\u0000\u0000
��=
�@\u0010\u0005�s�%\u0007X�l��DHo#�x�Ռ��(I��xw�FHc�O�~�k�x0<=Y�a.�����9L4�\u001b\u00008k\u001f	`��ԏ�\u0007�\u001a�\u000b.]\u001fZ\u0002�?q�Ρߕ���A\u001f�S��\���������3�낙93ɯ�Fo��;}���g�xʜ9c-\u001b\u0002\u00030����������U#�Y6�T\u000b��Ҧ3�
�Nn��\u0016EQ\u0014���\u0001\u0008�b\u001c\u0000\u000c\u0000\u0000,"Value cannot be null. (Parameter 'source')")
Bicep.Core.IntegrationTests.AzTypesViaRegistryTests ‑ Bicep_compiler_handles_corrupted_extension_package_gracefully (\u001f�\u0008\u0000\u0000\u0000\u0000\u0000\u0000\u0003��;
�@\u0010\u0006�s�%\u0007��f\u001fI��6��\u0007X͈��!�@@��h#��ɣ�~�4S�0�ã���d\u000bj\u001c��M�al��F��D��D��`?1�\u0002��\u000c:��\u0006\u0010a�D�j�^�kUP�o�Q\u0005q���ZR.\u0012�L��h�P\u001ae�\u0006K��F��;L�o��\u0002���&VB\u001a@��	�f�d���?Yx�����R���HM�ag{w�Z:��y�\u0007�y\u0003*p�6\u0000\u000c\u0000\u0000,"Value cannot be null. (Parameter 'source')")
Bicep.Core.IntegrationTests.AzTypesViaRegistryTests ‑ Bicep_compiler_handles_corrupted_extension_package_gracefully (\u001f�\u0008\u0000\u0000\u0000\u0000\u0000\u0000\u0003��=
�@\u0010\u0005�=�'X��Ϭ)�S�
\u000b\u0011�k�J���\u0007R\u0005�4F\u000b�k^3��\u0010�}\u001d���S\u0006N
Es\u0003\u0000���\u0000�	\u0008O�|�\u0005\u000c]\u001f�\u0004�6i�o�?UC���\u0011եkc�˼��M]�\u0017+�RC\u0014�v�q�v�dV���?���hb�lD[6B`\u0018\u000f�\u0017����?_k7H�$Ih\u0005o�U8*\u0000\u000c\u0000\u0000,"The path: index.json was not found in artifact contents")
…

♻️ This comment has been updated with latest results.