Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 0 additions & 6 deletions .idea/copilot.data.migration.agent.xml

This file was deleted.

6 changes: 0 additions & 6 deletions .idea/copilot.data.migration.edit.xml

This file was deleted.

7 changes: 0 additions & 7 deletions .idea/dictionaries/project.xml

This file was deleted.

15 changes: 0 additions & 15 deletions .idea/docs.duendesoftware.com.iml

This file was deleted.

27 changes: 0 additions & 27 deletions .idea/runConfigurations/Dockerfile.xml

This file was deleted.

21 changes: 21 additions & 0 deletions .opencode/agent/docs-writer.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
description: Writes and maintains documentation for Duende Software products, including IdentityServer and Backend for Frontend.
mode: all
tools:
write: true
edit: true
bash: true
webfetch: true
question: true
lsp: true
---

You are a technical documentation writer, with expert-level background in ASP.NET Core, OpenID Connect, OAuth, and general .NET development.
Create clear, comprehensive documentation. Ask clarifying questions if there is ambiguity or something isn't clear.

Focus on:

* Clear explanations
* Proper structure
* Code examples
* User-friendly language
11 changes: 11 additions & 0 deletions .opencode/rules/writing-guidelines.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
* Strictly follow the authoring and style guides from `README.md`
* Do not use conversational filler or "fluff" in the generated documentation. Get straight to the point.
* Always check the file structure and existing content to ensure consistent links and hierarchy.
* Never invent features or configuration options. If you are unsure, ask the user.
* Code generation - Prioritize complete, runnable examples over snippets. Ensure standard formatting.

When writing Markdown content Markdown:
* Use `*` for lists. Do not use `-`.
* Use `[link title](https://example.com)` for links, avoid reference-style links unless there are multiple occurences of the same link in one document.
* For internal links, always include the extension (e.g. `.md` or `.mdx`)
* Prefer `csharp` over `cs` to set the language for C# code blocks.
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -99,6 +99,8 @@ Static assets, like favicons, can be placed in the `astro/public/` directory.

## ✍️ Authoring

The `astro/` folder has been configured as a VS Code and WebStorm project, which you can open from that location to work on content.

Content can be authored in Markdown, in a `.md` or `.mdx` file. The Starlight documentation has some guidance on Markdown syntax, components, and more:

* [Authoring Content in Markdown](https://starlight.astro.build/guides/authoring-content/)
Expand Down
File renamed without changes.
70 changes: 70 additions & 0 deletions astro/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
# Astro build output
astro/dist/
astro/root/
server/src/Docs.Web/wwwroot/

# generated types
astro/.astro/

# dependencies
node_modules/

# logs
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*


# environment variables
.env
.env.production

# macOS-specific files
.DS_Store
.vscode/settings.json
*.iml

# Agents and assistants
.opencode/
opencode.json
.idea/**/copilot.data.migration.*.xml

# .NET
*.user
*.suo
*.userosscache
*.sln.docstates
[Bb]in/
[Oo]bj/
[Ll]og/
[Ll]ogs/
.vs/
*.nupkg
*.snupkg
project.lock.json
project.fragment.lock.json
artifacts/

# Rider
.idea/**/workspace.xml
.idea/**/tasks.xml
.idea/**/usage.statistics.xml
.idea/**/dictionaries
.idea/**/shelf

# User-specific files
*.rsuser

# JetBrains Rider
*.sln.iml

# ASP.NET Scaffolding
ScaffoldingReadMe.txt

# Windows
Thumbs.db
ehthumbs.db

# Azure Functions
local.settings.json
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
1 change: 1 addition & 0 deletions .idea/vcs.xml → astro/.idea/vcs.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

File renamed without changes.
File renamed without changes.
File renamed without changes.
8 changes: 8 additions & 0 deletions opencode.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"$schema": "https://opencode.ai/config.json",
"instructions": ["README.md", ".opencode/rules/writing-guidelines.md"],
"plugin": ["@opencode_weave/weave"],
"watcher": {
"ignore": ["node_modules/**", "dist/**", ".git/**"]
}
}
15 changes: 15 additions & 0 deletions server/.idea/.idea.Docs/.idea/.gitignore

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

1 change: 1 addition & 0 deletions server/.idea/.idea.Docs/.idea/.name

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 4 additions & 0 deletions server/.idea/.idea.Docs/.idea/encodings.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 6 additions & 0 deletions server/.idea/.idea.Docs/.idea/externalDependencies.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

8 changes: 8 additions & 0 deletions server/.idea/.idea.Docs/.idea/indexLayout.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 4 additions & 0 deletions server/.idea/.idea.Docs/.idea/misc.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 6 additions & 0 deletions server/.idea/.idea.Docs/.idea/vcs.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion server/src/Docs.AppHost/Program.cs
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
var builder = DistributedApplication.CreateBuilder(args);

// Astro dev server (for local development only)
_ = builder.AddJavaScriptApp("astro", "../../astro")
_ = builder.AddJavaScriptApp("astro", "../../../astro")
.WithHttpEndpoint(port: 4321, env: "PORT")
.WithExternalHttpEndpoints();

Expand Down
15 changes: 1 addition & 14 deletions server/src/Docs.AppHost/Properties/launchSettings.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,26 +5,13 @@
"commandName": "Project",
"dotnetRunMessages": true,
"launchBrowser": true,
"applicationUrl": "https://localhost:17001;http://localhost:17000",
"applicationUrl": "https://localhost:17001",
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development",
"DOTNET_ENVIRONMENT": "Development",
"DOTNET_DASHBOARD_OTLP_ENDPOINT_URL": "https://localhost:21001",
"DOTNET_RESOURCE_SERVICE_ENDPOINT_URL": "https://localhost:22001"
}
},
"http": {
"commandName": "Project",
"dotnetRunMessages": true,
"launchBrowser": true,
"applicationUrl": "http://localhost:17000",
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development",
"DOTNET_ENVIRONMENT": "Development",
"DOTNET_DASHBOARD_OTLP_ENDPOINT_URL": "http://localhost:19001",
"DOTNET_RESOURCE_SERVICE_ENDPOINT_URL": "http://localhost:20001",
"ASPIRE_ALLOW_UNSECURED_TRANSPORT": "true"
}
}
}
}
Loading
Loading