[Doc] Update upgrade faq (#1313)

# Description

Please add an informative description that covers that changes made by
the pull request and link all relevant issues.

# All Promptflow Contribution checklist:
- [ ] **The pull request does not introduce [breaking changes].**
- [ ] **CHANGELOG is updated for new features, bug fixes or other
significant changes.**
- [ ] **I have read the [contribution guidelines](../CONTRIBUTING.md).**
- [ ] **Create an issue and link to the pull request to get dedicated
review from promptflow team. Learn more: [suggested
workflow](../CONTRIBUTING.md#suggested-workflow).**

## General Guidelines and Best Practices
- [ ] Title of the pull request is clear and informative.
- [ ] There are a small number of commits, each of which have an
informative message. This means that previously merged commits do not
appear in the history of the PR. For more information on cleaning up the
commits in your PR, [see this
page](https://github.com/Azure/azure-powershell/blob/master/documentation/development-docs/cleaning-up-commits.md).

### Testing Guidelines
- [ ] Pull request includes test coverage for the included changes.

---------

Signed-off-by: Brynn Yin <[email protected]>

Author: brynn-code

docs/how-to-guides/faq.md

@@ -11,6 +11,18 @@ Prompt flow provides both stable and experimental features in the same SDK.
 Stable features	| **Production ready** <br/><br/> These features are recommended for most use cases and production environments. They are updated less frequently then experimental features.|
 Experimental features | **Developmental**  <br/><br/> These features are newly developed capabilities & updates that may not be ready or fully tested for production usage. While the features are typically functional, they can include some breaking changes. Experimental features are used to iron out SDK breaking bugs, and will only receive updates for the duration of the testing period. Experimental features are also referred to as features that are in **preview**. <br/> As the name indicates, the experimental (preview) features are for experimenting and is **not considered bug free or stable**. For this reason, we only recommend experimental features to advanced users who wish to try out early versions of capabilities and updates, and intend to participate in the reporting of bugs and glitches.
 
+
+### OpenAI 1.x support
+Please use the following command to upgrade promptflow for openai 1.x support:
+```
+pip install promptflow>=1.1.0
+pip install promptflow-tools>=1.0.0
+```
+Note that the command above will upgrade your openai package a version later than 1.0.0, 
+which may introduce breaking changes to custom tool code.
+
+Reach [OpenAI migration guide](https://github.com/openai/openai-python/discussions/742) for more details.
+
 ## Troubleshooting ##
 
 ### Connection creation failed with StoreConnectionEncryptionKeyError
@@ -20,7 +32,7 @@ Connection creation failed with StoreConnectionEncryptionKeyError: System keyrin
 ```
 
 This error raised due to keyring can't find an available backend to store keys.
-For example [macOs Keychain](https://en.wikipedia.org/wiki/Keychain_%28software%29) and [Windows Credential Locker](https://learn.microsoft.com/en-us/windows/uwp/security/credential-locker)
+For example [macOS Keychain](https://en.wikipedia.org/wiki/Keychain_%28software%29) and [Windows Credential Locker](https://learn.microsoft.com/en-us/windows/uwp/security/credential-locker)
 are valid keyring backends.
 
 To resolve this issue, install the third-party keyring backend or write your own keyring backend, for example:

scripts/docs/_static/custom.css

@@ -20,6 +20,18 @@
     max-width: 70em;
 }
 
+html[data-theme="light"] {
+    --header-announcement-color: #fff070;
+}
+
+html[data-theme="dark"] {
+    --header-announcement-color: #4d4d00;
+}
+
+.bd-header-announcement {
+    background: var(--header-announcement-color);
+}
+
 /* (A) LIGHTBOX BACKGROUND */
 #lightbox {
     /* (A1) COVERS FULLSCREEN */

scripts/docs/conf.py

@@ -93,7 +93,10 @@
     "show_toc_level": 1,
     "navbar_align": "left",  # [left, content, right] For testing that the navbar items align properly
     "navbar_center": ["navbar-nav"],
-    # "announcement": "Test our announcement here.",
+    "announcement":
+        "Prompt flow supports OpenAI 1.x since v1.1.0. This may introduce breaking change. Reach "
+        "<a href='https://microsoft.github.io/promptflow/how-to-guides/faq.html#openai-1-x-support'>here</a> "
+        "for guide to upgrade.",
     "show_nav_level": 1,
 }