Skip to content

Commit eaba73f

Browse files
committed
Update to latest Hugo version, move Hugo config to yaml, update folder structure, update partials.
Signed-off-by: Marc Duiker <[email protected]>
1 parent fa4bac1 commit eaba73f

File tree

444 files changed

+10078
-5247
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

444 files changed

+10078
-5247
lines changed

.devcontainer/devcontainer.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
},
1111
"ghcr.io/devcontainers/features/hugo:1": {
1212
"extended": true,
13-
"version": "0.100.2"
13+
"version": "0.147.9"
1414
},
1515
"ghcr.io/devcontainers/features/node:1": {
1616
"nodeGypDependencies": true,

.github/pull_request_template.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,11 @@ Thank you for helping make the Dapr documentation better!
33
**Please follow this checklist before submitting:**
44
- [ ] Commits are signed with Developer Certificate of Origin (DCO - [learn more](https://docs.dapr.io/contributing/contributing-overview/#developer-certificate-of-origin-signing-your-work))
55
- [ ] [Read the contribution guide](https://docs.dapr.io/contributing/docs-contrib/contributing-docs/)
6-
- [ ] Commands include options for Linux, MacOS, and Windows within codetabs
6+
- [ ] Commands include options for Linux, MacOS, and Windows within tabpane
77
- [ ] New file and folder names are globally unique
88
- [ ] Page references use shortcodes instead of markdown or URL links
99
- [ ] Images use HTML style and have alternative text
10-
- [ ] Places where multiple code/command options are given have codetabs
10+
- [ ] Places where multiple code/command options are given have tabpane
1111

1212
In addition, please fill out the following to help reviewers understand this pull request:
1313

.gitmodules

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,3 @@
1-
[submodule "daprdocs/themes/docsy"]
2-
path = daprdocs/themes/docsy
3-
url = https://github.com/google/docsy.git
41
[submodule "sdkdocs/python"]
52
path = sdkdocs/python
63
url = https://github.com/dapr/python-sdk.git

.vscode/settings.json

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"cSpell.ignoreWords": [
3+
"Dapr"
4+
],
5+
"cSpell.words": [
6+
"Dapr"
7+
]
8+
}

daprdocs/content/en/_index.md

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Dapr is a portable, event-driven runtime that makes it easy for any developer to
1212
stateless and stateful applications that run on the cloud and edge and embraces the diversity of
1313
languages and developer frameworks. Leveraging the benefits of a sidecar architecture, Dapr helps
1414
you tackle the challenges that come with building microservices and keeps your code platform agnostic.
15-
{{< button text="Get started" page="getting-started" >}}
15+
{{< button text="Get started" page="getting-started.md" >}}
1616
{{% /alert %}}
1717

1818

@@ -23,21 +23,21 @@ you tackle the challenges that come with building microservices and keeps your c
2323
<div class="card-body">
2424
<h5 class="card-title"><b>Getting started</b></h5>
2525
<p class="card-text">How to get up and running with Dapr in your environment in minutes.</p>
26-
<a href="{{< ref getting-started >}}" class="stretched-link"></a>
26+
<a href="{{% ref getting-started %}}" class="stretched-link"></a>
2727
</div>
2828
</div>
2929
<div class="card">
3030
<div class="card-body">
3131
<h5 class="card-title"><b>Quickstarts</b></h5>
3232
<p class="card-text">A collection of tutorials with code samples to get you started quickly with Dapr.</p>
33-
<a href="{{< ref quickstarts >}}" class="stretched-link"></a>
33+
<a href="{{% ref quickstarts %}}" class="stretched-link"></a>
3434
</div>
3535
</div>
3636
<div class="card">
3737
<div class="card-body">
3838
<h5 class="card-title"><b>Concepts</b></h5>
3939
<p class="card-text">Learn about Dapr, including its main features and capabilities.</p>
40-
<a href="{{< ref concepts >}}" class="stretched-link"></a>
40+
<a href="{{% ref concepts %}}" class="stretched-link"></a>
4141
</div>
4242
</div>
4343
</div>
@@ -50,21 +50,21 @@ you tackle the challenges that come with building microservices and keeps your c
5050
<div class="card-body">
5151
<h5 class="card-title"><b>Developing applications</b></h5>
5252
<p class="card-text">Tools, tips, and information on how to build your application with Dapr.</p>
53-
<a href="{{< ref developing-applications >}}" class="stretched-link"></a>
53+
<a href="{{% ref developing-applications %}}" class="stretched-link"></a>
5454
</div>
5555
</div>
5656
<div class="card">
5757
<div class="card-body">
5858
<h5 class="card-title"><b>Building blocks</b></h5>
5959
<p class="card-text">Capabilities that solve common development challenges for distributed applications.</p>
60-
<a href="{{< ref building-blocks-concept >}}" class="stretched-link"></a>
60+
<a href="{{% ref building-blocks-concept %}}" class="stretched-link"></a>
6161
</div>
6262
</div>
6363
<div class="card">
6464
<div class="card-body">
6565
<h5 class="card-title"><b>Operations</b></h5>
6666
<p class="card-text">Hosting options, best-practices, and other guides and running your application on Dapr.</p>
67-
<a href="{{< ref operations >}}" class="stretched-link"></a>
67+
<a href="{{% ref operations %}}" class="stretched-link"></a>
6868
</div>
6969
</div>
7070
</div>
@@ -77,21 +77,21 @@ you tackle the challenges that come with building microservices and keeps your c
7777
<div class="card-body">
7878
<h5 class="card-title"><b>Reference</b></h5>
7979
<p class="card-text">Detailed documentation on the Dapr API, CLI, bindings and more.</p>
80-
<a href="{{< ref reference >}}" class="stretched-link"></a>
80+
<a href="{{% ref reference %}}" class="stretched-link"></a>
8181
</div>
8282
</div>
8383
<div class="card">
8484
<div class="card-body">
8585
<h5 class="card-title"><b>Contributing</b></h5>
8686
<p class="card-text">How to contribute to the Dapr project and the various repositories.</p>
87-
<a href="{{< ref contributing >}}" class="stretched-link"></a>
87+
<a href="{{% ref contributing %}}" class="stretched-link"></a>
8888
</div>
8989
</div>
9090
<div class="card">
9191
<div class="card-body">
9292
<h5 class="card-title"><b>Roadmap</b></h5>
9393
<p class="card-text">Learn about Dapr's roadmap and change process.</p>
94-
<a href="{{< ref roadmap.md >}}" class="stretched-link"></a>
94+
<a href="{{% ref roadmap.md %}}" class="stretched-link"></a>
9595
</div>
9696
</div>
9797
</div>
@@ -109,7 +109,7 @@ you tackle the challenges that come with building microservices and keeps your c
109109
<p class="card-text">
110110
Learn how to get up and running with Dapr in your preferred integrated development environment.
111111
</p>
112-
<a href="{{< ref ides >}}" class="stretched-link"></a>
112+
<a href="{{% ref ides %}}" class="stretched-link"></a>
113113
</div>
114114
</div>
115115
</div>
@@ -124,7 +124,7 @@ you tackle the challenges that come with building microservices and keeps your c
124124
<p class="card-text">
125125
Create Dapr applications in your preferred language using the Dapr SDKs.
126126
</p>
127-
<a href="{{< ref sdks >}}" class="stretched-link"></a>
127+
<a href="{{% ref sdks %}}" class="stretched-link"></a>
128128
</div>
129129
</div>
130130
</div>
@@ -139,7 +139,7 @@ you tackle the challenges that come with building microservices and keeps your c
139139
<p class="card-text">
140140
Learn more about the .NET SDK.
141141
</p>
142-
<a href="{{< ref dotnet >}}" class="stretched-link"></a>
142+
<a href="{{% ref dotnet %}}" class="stretched-link"></a>
143143
</div>
144144
</div>
145145
<div class="card">
@@ -151,7 +151,7 @@ you tackle the challenges that come with building microservices and keeps your c
151151
<p class="card-text">
152152
Learn more about the Python SDK.
153153
</p>
154-
<a href="{{< ref python >}}" class="stretched-link"></a>
154+
<a href="{{% ref python %}}" class="stretched-link"></a>
155155
</div>
156156
</div>
157157
<div class="card">
@@ -163,7 +163,7 @@ you tackle the challenges that come with building microservices and keeps your c
163163
<p class="card-text">
164164
Learn more about the JavaScript SDK.
165165
</p>
166-
<a href="{{< ref js >}}" class="stretched-link"></a>
166+
<a href="{{% ref js %}}" class="stretched-link"></a>
167167
</div>
168168
</div>
169169
</div>
@@ -178,7 +178,7 @@ you tackle the challenges that come with building microservices and keeps your c
178178
<p class="card-text">
179179
Learn more about the Java SDK.
180180
</p>
181-
<a href="{{< ref java >}}" class="stretched-link"></a>
181+
<a href="{{% ref java %}}" class="stretched-link"></a>
182182
</div>
183183
</div>
184184
<div class="card">
@@ -190,7 +190,7 @@ you tackle the challenges that come with building microservices and keeps your c
190190
<p class="card-text">
191191
Learn more about the Go SDK.
192192
</p>
193-
<a href="{{< ref go >}}" class="stretched-link"></a>
193+
<a href="{{% ref go %}}" class="stretched-link"></a>
194194
</div>
195195
</div>
196196
<div class="card">
@@ -202,7 +202,7 @@ you tackle the challenges that come with building microservices and keeps your c
202202
<p class="card-text">
203203
Learn more about the PHP SDK.
204204
</p>
205-
<a href="{{< ref php >}}" class="stretched-link"></a>
205+
<a href="{{% ref php %}}" class="stretched-link"></a>
206206
</div>
207207
</div>
208208
</div>

daprdocs/content/en/concepts/_index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,6 @@ Welcome to the Dapr concepts guide!
1111

1212
{{% alert title="Getting started with Dapr" color="primary" %}}
1313
If you are ready to jump in and start developing with Dapr, please
14-
visit the [getting started section]({{<ref getting-started>}}).
15-
{{< button text="Install Dapr" page="getting-started" >}}
14+
visit the [getting started section]({{%ref getting-started%}}).
15+
{{< button text="Install Dapr" page="getting-started.md" >}}
1616
{{% /alert %}}

daprdocs/content/en/concepts/building-blocks-concept.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ weight: 200
66
description: "Modular best practices accessible over standard HTTP or gRPC APIs"
77
---
88

9-
A [building block]({{< ref building-blocks >}}) is an HTTP or gRPC API that can be called from your code and uses one or more Dapr components. Dapr consists of a set of API building blocks, with extensibility to add new building blocks. Dapr's building blocks:
9+
A [building block]({{% ref building-blocks %}}) is an HTTP or gRPC API that can be called from your code and uses one or more Dapr components. Dapr consists of a set of API building blocks, with extensibility to add new building blocks. Dapr's building blocks:
1010
- Address common challenges in building resilient, microservices applications
1111
- Codify best practices and patterns
1212

@@ -20,15 +20,15 @@ Dapr provides the following building blocks:
2020

2121
| Building Block | Endpoint | Description |
2222
|----------------|----------|-------------|
23-
| [**Service-to-service invocation**]({{< ref "service-invocation-overview.md" >}}) | `/v1.0/invoke` | Service invocation enables applications to communicate with each other through well-known endpoints in the form of http or gRPC messages. Dapr provides an endpoint that acts as a combination of a reverse proxy with built-in service discovery, while leveraging built-in distributed tracing and error handling.
24-
| [**Publish and subscribe**]({{< ref "pubsub-overview.md" >}}) | `/v1.0/publish` `/v1.0/subscribe`| Pub/Sub is a loosely coupled messaging pattern where senders (or publishers) publish messages to a topic, to which subscribers subscribe. Dapr supports the pub/sub pattern between applications.
25-
| [**Workflows**]({{< ref "workflow-overview.md" >}}) | `/v1.0/workflow` | The Workflow API enables you to define long running, persistent processes or data flows that span multiple microservices using Dapr workflows. The Workflow API can be combined with other Dapr API building blocks. For example, a workflow can call another service with service invocation or retrieve secrets, providing flexibility and portability.
26-
| [**State management**]({{< ref "state-management-overview.md" >}}) | `/v1.0/state` | Application state is anything an application wants to preserve beyond a single session. Dapr provides a key/value-based state and query APIs with pluggable state stores for persistence.
27-
| [**Bindings**]({{< ref "bindings-overview.md" >}}) | `/v1.0/bindings` | A binding provides a bi-directional connection to an external cloud/on-premise service or system. Dapr allows you to invoke the external service through the Dapr binding API, and it allows your application to be triggered by events sent by the connected service.
28-
| [**Actors**]({{< ref "actors-overview.md" >}}) | `/v1.0/actors` | An actor is an isolated, independent unit of compute and state with single-threaded execution. Dapr provides an actor implementation based on the virtual actor pattern which provides a single-threaded programming model and where actors are garbage collected when not in use.
29-
| [**Secrets**]({{< ref "secrets-overview.md" >}}) | `/v1.0/secrets` | Dapr provides a secrets building block API and integrates with secret stores such as public cloud stores, local stores and Kubernetes to store the secrets. Services can call the secrets API to retrieve secrets, for example to get a connection string to a database.
30-
| [**Configuration**]({{< ref "configuration-api-overview.md" >}}) | `/v1.0/configuration` | The Configuration API enables you to retrieve and subscribe to application configuration items for supported configuration stores. This enables an application to retrieve specific configuration information, for example, at start up or when configuration changes are made in the store.
31-
| [**Distributed lock**]({{< ref "distributed-lock-api-overview.md" >}}) | `/v1.0-alpha1/lock` | The distributed lock API enables you to take a lock on a resource so that multiple instances of an application can access the resource without conflicts and provide consistency guarantees.
32-
| [**Cryptography**]({{< ref "cryptography-overview.md" >}}) | `/v1.0-alpha1/crypto` | The Cryptography API enables you to perform cryptographic operations, such as encrypting and decrypting messages, without exposing keys to your application.
33-
| [**Jobs**]({{< ref "jobs-overview.md" >}}) | `/v1.0-alpha1/jobs` | The Jobs API enables you to schedule and orchestrate jobs. Example scenarios include: <ul><li>Schedule batch processing jobs to run every business day</li><li>Schedule various maintenance scripts to perform clean-ups</li><li>Schedule ETL jobs to run at specific times (hourly, daily) to fetch new data, process it, and update the data warehouse with the latest information.</li></ul>
34-
| [**Conversation**]({{< ref "conversation-overview.md" >}}) | `/v1.0-alpha1/conversation` | The Conversation API enables you to supply prompts to converse with different large language models (LLMs) and includes features such as prompt caching and personally identifiable information (PII) obfuscation.
23+
| [**Service-to-service invocation**]({{% ref "service-invocation-overview" %}}) | `/v1.0/invoke` | Service invocation enables applications to communicate with each other through well-known endpoints in the form of http or gRPC messages. Dapr provides an endpoint that acts as a combination of a reverse proxy with built-in service discovery, while leveraging built-in distributed tracing and error handling.
24+
| [**Publish and subscribe**]({{% ref "pubsub-overview" %}}) | `/v1.0/publish` `/v1.0/subscribe`| Pub/Sub is a loosely coupled messaging pattern where senders (or publishers) publish messages to a topic, to which subscribers subscribe. Dapr supports the pub/sub pattern between applications.
25+
| [**Workflows**]({{% ref "workflow-overview" %}}) | `/v1.0/workflow` | The Workflow API enables you to define long running, persistent processes or data flows that span multiple microservices using Dapr workflows. The Workflow API can be combined with other Dapr API building blocks. For example, a workflow can call another service with service invocation or retrieve secrets, providing flexibility and portability.
26+
| [**State management**]({{% ref "state-management-overview" %}}) | `/v1.0/state` | Application state is anything an application wants to preserve beyond a single session. Dapr provides a key/value-based state and query APIs with pluggable state stores for persistence.
27+
| [**Bindings**]({{% ref "bindings-overview" %}}) | `/v1.0/bindings` | A binding provides a bi-directional connection to an external cloud/on-premise service or system. Dapr allows you to invoke the external service through the Dapr binding API, and it allows your application to be triggered by events sent by the connected service.
28+
| [**Actors**]({{% ref "actors-overview" %}}) | `/v1.0/actors` | An actor is an isolated, independent unit of compute and state with single-threaded execution. Dapr provides an actor implementation based on the virtual actor pattern which provides a single-threaded programming model and where actors are garbage collected when not in use.
29+
| [**Secrets**]({{% ref "secrets-overview" %}}) | `/v1.0/secrets` | Dapr provides a secrets building block API and integrates with secret stores such as public cloud stores, local stores and Kubernetes to store the secrets. Services can call the secrets API to retrieve secrets, for example to get a connection string to a database.
30+
| [**Configuration**]({{% ref "configuration-api-overview" %}}) | `/v1.0/configuration` | The Configuration API enables you to retrieve and subscribe to application configuration items for supported configuration stores. This enables an application to retrieve specific configuration information, for example, at start up or when configuration changes are made in the store.
31+
| [**Distributed lock**]({{% ref "distributed-lock-api-overview" %}}) | `/v1.0-alpha1/lock` | The distributed lock API enables you to take a lock on a resource so that multiple instances of an application can access the resource without conflicts and provide consistency guarantees.
32+
| [**Cryptography**]({{% ref "cryptography-overview" %}}) | `/v1.0-alpha1/crypto` | The Cryptography API enables you to perform cryptographic operations, such as encrypting and decrypting messages, without exposing keys to your application.
33+
| [**Jobs**]({{% ref "jobs-overview" %}}) | `/v1.0-alpha1/jobs` | The Jobs API enables you to schedule and orchestrate jobs. Example scenarios include: <ul><li>Schedule batch processing jobs to run every business day</li><li>Schedule various maintenance scripts to perform clean-ups</li><li>Schedule ETL jobs to run at specific times (hourly, daily) to fetch new data, process it, and update the data warehouse with the latest information.</li></ul>
34+
| [**Conversation**]({{% ref "conversation-overview" %}}) | `/v1.0-alpha1/conversation` | The Conversation API enables you to supply prompts to converse with different large language models (LLMs) and includes features such as prompt caching and personally identifiable information (PII) obfuscation.

0 commit comments

Comments
 (0)