Azure / api-management-developer-portal

Developer portal provided by the Azure API Management service.
MIT License
488 stars 318 forks source link

UX/CI issue on API details page and Try it panel - unconfigurable text and border colors #971

Closed AnRei123 closed 7 months ago

AnRei123 commented 4 years ago

Bug description

I chose the following settings on the style page for formatting code snippets: LayoutPagePreview

On the API details page and the related Try it panel, there are a few UX/CI issues regarding some font and frame colors that cannot be configured currently:

1) On the API details page in the Example boxes, the text is displayed with two colors (violet and green) that seem not to be configurable on the Styles page of the portal. Is there any other way to configure these styles color according to our CI colors and according to ensure legibility depending on the chosen background color?

2) On the Try it panel on the top, there are boxes with green frame color to select or enter dedicated values for an API request. I tried to change the color of the frame in the section form controls on the style page of the DevPortal, but even on the styles page my changes are not reflecting. I cannot change the color of the frame. Looks like a bug. This green is not consistent to our CI branding colors. FormControlBorderColor

3) On the Try it panel at the end, for the http request details frame, the background color is not in synch with the configuration on the Styles page of the DevPortal, but here parts of the font colors and the frame color is synched with the settings on the Styles page. There is a blue font that I do not know how to change, for example, the blue font of the term "Cache control".

Here a screenshot to depict how the above shown settings on the Styles page do currently reflect on the API details page and the Try it panel: ApiDetailsPageAndTryItPanel

Expected behavior

All colors for texts and frames that are visible to the portal users are consistently configurable from the Styles page of the portal.

(I thought about using a black background color for displaying code snippets, but with the current configuration options this does not make sense as the preconfigured color schema for the fonts in the example box are two dark. As a work around, I chose the grey background color which is also fine, but the preconfigured text and frame colors do NOT fit with our CI colors!)

Is your portal managed or self-hosted?

Managed

Environment

AnRei123 commented 4 years ago

Add on: The color of the Try it button on the API details widget should also be configurable on the Styles page of the DevPortal.

azaslonov commented 4 years ago

Makes sense. We'll add customization options.

mrcarlosdev commented 7 months ago

This issue is related to managed developer portal. We advise you to create a Azure support request to get assistance on this issue. Please refer to the below link to create a new Azure support request, Please select Problem Type = "Developer Portal" in the request to route it appropriately.

https://learn.microsoft.com/en-us/azure/azure-portal/supportability/how-to-create-azure-support-request