Skip to content

Commit 14fe0eb

Browse files
committed
Update image paths to use the /web prefix for all blog posts and improve documentation clarity
1 parent f8add44 commit 14fe0eb

File tree

21 files changed

+76
-76
lines changed

21 files changed

+76
-76
lines changed

astro.config.mjs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ import tailwindcss from '@tailwindcss/vite';
66
// https://astro.build/config
77
export default defineConfig({
88
site: 'https://dev-proxy-tools.github.io',
9-
base: '/',
9+
base: '/web/',
1010
vite: {
1111
plugins: [tailwindcss()]
1212
}

src/content/blog/building-custom-copilots-in-microsoft-teams-with-teams-app-test-tool-and-dev-proxy.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -14,11 +14,11 @@ Many organizations are building custom copilots grounded in organizational data
1414

1515
The [ChatGPT + Enterprise data with Azure OpenAI and AI Search](https://github.com/Azure-Samples/azure-search-openai-demo) sample is an example of how to implement RAG on the Microsoft Cloud.
1616

17-
![Retrieval Augmented Generation (RAG) architecture](/blog/images/word-image-20254-1.png)
17+
![Retrieval Augmented Generation (RAG) architecture](/web/blog/images/word-image-20254-1.png)
1818

1919
Employees use natural language to ask questions and receive answers based on data from a fictitious company called Contoso Electronics. Allowing them to ask questions about the benefits, internal policies, as well as job descriptions and roles.
2020

21-
![Chat interface in the web application](/blog/images/chat-screen.png)
21+
![Chat interface in the web application](/web/blog/images/chat-screen.png)
2222

2323
Requests are sent to a back-end API when employees submit queries. Answers are returned in natural language along with document citations and follow-up questions in the response which are displayed in the user interface.
2424

@@ -30,15 +30,15 @@ In the [ChatGPT + Enterprise data with Azure OpenAI and Cognitive Search in Micr
3030

3131
The bot sends requests to the same back-end API to return answers from the LLM.
3232

33-
![Chat interface in Microsoft Teams bot](/blog/images/chat-with-your-data-bot-in-microsoft-teams.png)
33+
![Chat interface in Microsoft Teams bot](/web/blog/images/chat-with-your-data-bot-in-microsoft-teams.png)
3434

3535
The answers, along with document citations and action buttons, are returned in Adaptive Cards. In addition, follow-up questions are displayed as suggested actions.
3636

3737
## Removing platform dependencies
3838

3939
To run and develop the two sample projects that we've just seen, you need to setup and configure several cloud services, as well as have access to a Microsoft 365 tenant.
4040

41-
![Microsoft Teams bot with RAG architecture](/blog/images/a-diagram-of-a-software-company-description-autom.png)
41+
![Microsoft Teams bot with RAG architecture](/web/blog/images/a-diagram-of-a-software-company-description-autom.png)
4242

4343
During development this can be inefficient, in both time and money. It takes time to get everything in place and each request you send to the LLM incurs a cost as does keeping these services up and running.
4444

@@ -57,11 +57,11 @@ With Teams App Test Tool and Dev Proxy, you simulate only the dependencies you n
5757

5858
With Teams App Test Tool, you remove the dependency on a Microsoft 365 tenant, bot services, Microsoft Entra, and Dev Tunnels, whilst using real responses from the LLM.
5959

60-
![Removing dependencies with Teams App Test Tool](/blog/images/word-image-20254-6.png)
60+
![Removing dependencies with Teams App Test Tool](/web/blog/images/word-image-20254-6.png)
6161

6262
By adding Dev Proxy, you remove the dependency on all cloud services and APIs, whilst using mocked responses to simulate the LLM response without changing any of your app code.
6363

64-
![Removing dependencies with Dev Proxy](/blog/images/word-image-20254-7.png)
64+
![Removing dependencies with Dev Proxy](/web/blog/images/word-image-20254-7.png)
6565

6666
When you are ready to test against the live LLM, simply turn off Dev Proxy.
6767

@@ -80,11 +80,11 @@ To run and test the bot locally using Teams App Test Tool and Dev Proxy:
8080

8181
In the Test Tool, select the "What is included in my Northwind heal…" button to send a message in the bot chat and issue a request to the back-end API.
8282

83-
![Teams App Test Tool displaying the bot welcome message and answer to a question as Adaptive Cards](/blog/images/a-screenshot-of-a-computer-description-automatica.png)
83+
![Teams App Test Tool displaying the bot welcome message and answer to a question as Adaptive Cards](/web/blog/images/a-screenshot-of-a-computer-description-automatica.png)
8484

8585
In the Dev Proxy process output, you can see that the request to the back-end API is intercepted, a delay is added to simulate real-world latency, and the API response is mocked.
8686

87-
![Dev Proxy running in a terminal window inside Visual Studio Code, displaying a delayed mocked request to a backend API](/blog/images/a-screenshot-of-a-computer-description-automatica-1.png)
87+
![Dev Proxy running in a terminal window inside Visual Studio Code, displaying a delayed mocked request to a backend API](/web/blog/images/a-screenshot-of-a-computer-description-automatica-1.png)
8888

8989
## Summary
9090

src/content/blog/dev-proxy-v0-13-with-new-guidance-and-inspecting-web-requests.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,15 +26,15 @@ One of the frequent requests that we got from you was for Dev Proxy to show more
2626

2727
We're excited to introduce a new plugin that uses Chrome DevTools Protocol to let you explore requests and responses!
2828

29-
![Edge Dev Tools showing requests and responses intercepted by Dev Proxy](/blog/images/Blog.png)
29+
![Edge Dev Tools showing requests and responses intercepted by Dev Proxy](/web/blog/images/Blog.png)
3030

3131
Using Chrome DevTools Protocol for inspecting requests intercepted by Dev Proxy is convenient for several reasons.
3232

3333
First of all, it's the same user interface that you already know from building web apps. Because Dev Proxy intercepts requests from all types of apps, you'll now be able to use the same set of tools for all API requests, including those issued by server-side code!
3434

3535
Dev Proxy is a command line tool, and its UI is limited by the textual nature of the terminal. Using Chrome DevTools Protocol takes Dev Proxy beyond the terminal and gives you a richer UX with the ability to filter requests and messages. You'll find it particularly convenient when using Dev Proxy with apps that issue many API requests. Using Chrome DevTools Protocol allows us to provide you with detailed information about all intercepted requests and responses without cluttering the terminal output.
3636

37-
![Dev Proxy messages warnings and guidance displayed in Edge Dev Tools](/blog/images/blog2.png)
37+
![Dev Proxy messages warnings and guidance displayed in Edge Dev Tools](/web/blog/images/blog2.png)
3838

3939
Depending on your preference, you can use DevTools in Edge, Edge Dev channel or Chrome to inspect requests intercepted by Dev Proxy. Check it out and let us know how you like it!
4040

@@ -44,7 +44,7 @@ Recently, we published [new guidance about Microsoft Search APIs](https://devblo
4444

4545
To help you understand where in your applications you're using OneDrive and SharePoint search APIs, and which you could update to use the recommended Microsoft Search APIs in Microsoft Graph, we introduce in this version of Dev Proxy new guidance plugin.
4646

47-
![Dev Proxy warning of using OneDrive and SharePoint search APIs](/blog/images/blogother.png)
47+
![Dev Proxy warning of using OneDrive and SharePoint search APIs](/web/blog/images/blogother.png)
4848

4949
## There's more
5050

src/content/blog/dev-proxy-v0-14-with-generating-openapi-specs-and-simulating-crud-apis.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Spend more time on building your app and less on plumbing. Make your apps more r
2424

2525
Starting from this version, you can configure Dev Proxy to combine rate limiting with mock responses. This means, that when testing how your app handles rate limiting, you won't be calling your API and incurring unnecessary load. This combination is invaluable to verify if your rate limiting code is working as expected.
2626

27-
![Dev Proxy simulating rate limiting using mock API responses](/blog/images/01.png)
27+
![Dev Proxy simulating rate limiting using mock API responses](/web/blog/images/01.png)
2828

2929
Learn more about [rate limiting](https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/concepts/what-is-rate-limiting).
3030

@@ -34,15 +34,15 @@ OpenAPI specs allow you to benefit from the latest investments in the API space.
3434

3535
Dev Proxy now allows you to generate an OpenAPI spec based on the requests intercepted by the proxy. All you need to do is to start your app, have it call your API, and Dev Proxy will generate an OpenAPI spec for you from the requests it intercepted!
3636

37-
![Dev Proxy generating an OpenAPI spec from the requests it intercepted](/blog/images/word-image-17765-2.png)
37+
![Dev Proxy generating an OpenAPI spec from the requests it intercepted](/web/blog/images/word-image-17765-2.png)
3838

3939
Learn more about [generating OpenAPI specs using Dev Proxy](https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/how-to/generate-openapi-spec).
4040

4141
## Simulate CRUD APIs for development
4242

4343
When building apps, you often interact with backend APIs. Sometimes, these APIs aren't yet available, or other teams are updating them to meet the latest requirements. To avoid waiting, you typically create a mock API that returns the data you need. While this approach unblocks you, it requires you to spend time on building an API that you eventually replace with the real one. To avoid wasting time, you can now use Dev Proxy to simulate a CRUD API and speed up development. All you need is a data set that you want to expose as an API and let Dev Proxy do the rest!
4444

45-
![Dev Proxy simulating a CRUD API for development](/blog/images/word-image-17765-3.png)
45+
![Dev Proxy simulating a CRUD API for development](/web/blog/images/word-image-17765-3.png)
4646

4747
Learn more about [simulating CRUD APIs with Dev Proxy](https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/how-to/simulate-crud-api).
4848

@@ -56,7 +56,7 @@ We regularly publish Dev Proxy presets which configure proxy for specific use ca
5656

5757
To make it easier for you to use these presets, you can now use the `devproxy preset get` command, to download and unzip the preset. All you need is the preset ID which you find on the preset's page in the sample gallery.
5858

59-
![Easily downloading Dev Proxy presets from the sample gallery](/blog/images/02.png)
59+
![Easily downloading Dev Proxy presets from the sample gallery](/web/blog/images/02.png)
6060

6161
We hope that you find presets helpful and if you've got your own presets that you'd like to share with others, [submit them to the gallery](https://github.com/pnp/proxy-samples/blob/main/CONTRIBUTING.md)!
6262

@@ -66,7 +66,7 @@ We've slightly changed the shape of mocks that we use in Dev Proxy. As we extend
6666

6767
The new structure defines a request and response object and a collection of header objects.
6868

69-
![New Dev Proxy mock structure](/blog/images/word-image-17765-5.png)
69+
![New Dev Proxy mock structure](/web/blog/images/word-image-17765-5.png)
7070

7171
We've already updated all samples in the sample gallery to reflect this new structure. If you have your own mocks, you can convert them to the new format using a [script](https://github.com/waldekmastykarz/convert-devproxy-mocks).
7272

@@ -78,7 +78,7 @@ Dev Proxy and its plugins use JSON files to define their configuration. To help
7878

7979
Recently, we've published [our new docs on Microsoft Learn](https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/overview). We've included the reference content we had on our GitHub Wiki and extended it with additional conceptual docs, all to help you build more robust apps and get more out of Dev Proxy. Check them out and let us know how we can make them better.
8080

81-
![New Dev Proxy docs on Microsoft Learn](/blog/images/04.png)
81+
![New Dev Proxy docs on Microsoft Learn](/web/blog/images/04.png)
8282

8383
## There's more
8484

src/content/blog/dev-proxy-v0-15-with-simulating-crud-apis-secured-with-microsoft-entra.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ In this version, we extend the CrudApiPlugin with support for simulating APIs se
2929

3030
When defining your CRUD API, you can choose which aspect of the access token you want to validate, like the audience, issuer, permissions or token lifetime, which is perfect for working with simulated access tokens. You can also choose to validate the token signature to ensure that the app is using a real token!
3131

32-
![Dev Proxy simulating a CRUD API secured with Microsoft Entra](/blog/images/TODAY_01.png)
32+
![Dev Proxy simulating a CRUD API secured with Microsoft Entra](/web/blog/images/TODAY_01.png)
3333

3434
Learn more about [simulating CRUD APIs with Dev Proxy](https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/how-to/simulate-crud-api).
3535

@@ -39,15 +39,15 @@ Many apps built on Microsoft cloud are secured with Microsoft Entra. Before you
3939

4040
In this version we introduce the new EntraMockResponsePlugin which allows you to simulate OAuth flows. After detecting an OAuth flow, the plugin updates auth codes and simulated access tokens so that they're accepted by Microsoft Identity libraries.
4141

42-
![Dev Proxy simulating OAuth flow for an app built using Microsoft Graph Toolkit](/blog/images/Screenshot-2024-02-27-141313.png)
42+
![Dev Proxy simulating OAuth flow for an app built using Microsoft Graph Toolkit](/web/blog/images/Screenshot-2024-02-27-141313.png)
4343

4444
Stay tuned for more information and examples of using this plugin in the coming weeks.
4545

4646
## Improved monitoring URLs
4747

4848
To help you reuse your presets like generating OpenAPI specs, generating mocks, and execution summaries with different APIs, in this release we introduce a new option – urlsToWatch. This option enables you to provide URLs to watch from the command line. Simply use `-u` or `–urls-to-watch` and specify the URLs you want to monitor, without having to change your presets!
4949

50-
![Starting Dev Proxy with specifying URLs to monitor from the command line](/blog/images/TODAY_03.png)
50+
![Starting Dev Proxy with specifying URLs to monitor from the command line](/web/blog/images/TODAY_03.png)
5151

5252
In this version, we also introduce support for monitoring URLs on a specific port only! This is invaluable if you build apps, for example using .NET Aspire, where you have several APIs running locally and want to watch requests to one of them. This feature gives you fine-grained control over URL watching for a more precise developer experience.
5353

@@ -59,7 +59,7 @@ Plugins in Dev Proxy give you the ability configure it to your specific needs. W
5959

6060
Previously, we introduced the ability to add multiple instances of the same plugin. This is invaluable in cases where you want to, for example define multiple instances of CRUD APIs or define mocks which you can reuse across different presets. In this version, we improved this ability further by changing how plugins expose their command-line options, to avoid conflicts between the different instances.
6161

62-
![Sample Dev Proxy configuration with multiple instances of the same plugin](/blog/images/TODAY_04.png)
62+
![Sample Dev Proxy configuration with multiple instances of the same plugin](/web/blog/images/TODAY_04.png)
6363

6464
## More flexible simulating throttling
6565

src/content/blog/dev-proxy-v0-16-with-simulated-handling-teams-admin-center-notifications-for-microsoft-graph-connectors.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -25,11 +25,11 @@ When deploying Graph connectors in your organization, you should consider packag
2525

2626
In this release of Dev Proxy, we're excited to ship the ability for you to simulate the Teams Admin Center notification for enabling and disabling Graph connectors. With the new feature, you can test your code locally end to end: from validating the token, to creating the connection with the ticket from the notification. And you can do all of this locally without deploying anything to Microsoft 365!
2727

28-
![Dev Proxy simulating the Teams Admin Center notification for Graph connectors and mocking subsequent requests for validating the token and creating the external connection.](/blog/images/word-image-19958-1.png)
28+
![Dev Proxy simulating the Teams Admin Center notification for Graph connectors and mocking subsequent requests for validating the token and creating the external connection.](/web/blog/images/word-image-19958-1.png)
2929

3030
We not only simulate the Teams Admin Center notification. We also check if your code correctly implements the different steps, like properly responding to the notification request or including the ticket from the notification on the external connection creation request. If we see that one of the required steps is missing or implemented incorrectly, we'll warn you about it. This way you can find potential issues earlier and deploy your Graph connector with confidence.
3131

32-
![Dev Proxy warning about the lack of ticket on the request to create an external connection after receiving a Teams Admin Center notification](/blog/images/word-image-19958-2.png)
32+
![Dev Proxy warning about the lack of ticket on the request to create an external connection after receiving a Teams Admin Center notification](/web/blog/images/word-image-19958-2.png)
3333

3434
Learn more about [simulating the Teams Admin Center notification for Graph connectors using Dev Proxy](https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/how-to/mock-teams-admin-center-notification-graph-connectors).
3535

@@ -41,7 +41,7 @@ There are [several requirements](https://learn.microsoft.com/graph/connecting-ex
4141

4242
In this version of Dev Proxy, we're introducing a new Graph connector guidance plugin, which checks if your external connection is configured properly for use with Copilot for Microsoft 365. We start with validating if your external connection contains the required semantic labels. If it doesn't, we'll warn you and tell you which labels are missing.
4343

44-
![Dev Proxy showing an error after detecting a missing semantic label in an external connection schema provisioning request.](/blog/images/word-image-19958-3.png)
44+
![Dev Proxy showing an error after detecting a missing semantic label in an external connection schema provisioning request.](/web/blog/images/word-image-19958-3.png)
4545

4646
We'll be expanding our checks in the future and hope that they'll help you deploy your Graph connectors with confidence.
4747

@@ -53,7 +53,7 @@ Many applications these days rely on webhooks. Webhooks are a common way for sys
5353

5454
A common challenge for working with webhooks is simulating the change in the external system that triggers the webhook. In this version of Dev Proxy, we're introducing the MockRequestPlugin that allows you to send a preconfigured notification to your application with a single key press.
5555

56-
![Dev Proxy simulating a webhook notification request to a local API.](/blog/images/word-image-19958-4.png)
56+
![Dev Proxy simulating a webhook notification request to a local API.](/web/blog/images/word-image-19958-4.png)
5757

5858
By itself, the MockRequestPlugin is a convenient method to send webhook notifications to your app. You can configure the different requests in an easy way in your project and share them with your colleagues. The plugin is also a powerful building block for implementing specialized plugins which encapsulate some additional logic and guidance, such as the one we've just mentioned that simulates Teams Admin Center notifications for Graph connectors.
5959

@@ -65,15 +65,15 @@ Over the last year, Dev Proxy evolved into a powerful API simulator that support
6565

6666
To help you document your settings, we now introduce support for including comments in Dev Proxy configuration and plugin files.
6767

68-
![Dev Proxy configuration file with a comment](/blog/images/word-image-19958-5.png)
68+
![Dev Proxy configuration file with a comment](/web/blog/images/word-image-19958-5.png)
6969

7070
We hope that it'll help you keep relevant notes next to your configuration so that you can easily share it with your colleagues. Oh, and if you happen to use VSCode, use .jsonc as the file extension for your config files. It'll keep VSCode from highlighting comments as errors.
7171

7272
## Improved UI
7373

7474
As we keep extending Dev Proxy with new features, we want to help you get the most out of it. In this version, we extend the UI with a list of hotkeys that you can use with Dev Proxy to invoke its different features.
7575

76-
![Dev Proxy running in the terminal showing its hotkeys](/blog/images/word-image-19958-6.png)
76+
![Dev Proxy running in the terminal showing its hotkeys](/web/blog/images/word-image-19958-6.png)
7777

7878
## There's more
7979

0 commit comments

Comments
 (0)