-
Notifications
You must be signed in to change notification settings - Fork 0
Update dependencies #56
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
379edf2
b10ce8b
de2b794
7ea2dad
a1e6548
0712592
1295346
0809f9e
260aae9
86434db
6182d9e
703e896
8796720
f847470
f6d7a4f
fa95d26
bf966b4
80bb823
31e752a
cc2c928
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,51 @@ | ||
| --- | ||
| name: writer | ||
| description: > | ||
| Write, edit, and restructure user-facing and developer-facing documentation. | ||
| Use when asked to create/update docs such as `README.md`, `docs/**`, and | ||
| other Markdown documentation; | ||
| when drafting tutorials, guides, troubleshooting pages, or migration notes; and | ||
| when improving inline API documentation (KDoc) and examples. | ||
| --- | ||
|
|
||
| # Write documentation (repo-specific) | ||
|
|
||
| ## Decide the target and audience | ||
|
|
||
| - Identify the target reader: end user, contributor, maintainer, or tooling/automation. | ||
| - Identify the task type: new doc, update, restructure, or documentation audit. | ||
| - Identify the acceptance criteria: “what is correct when the reader is done?” | ||
|
|
||
| ## Choose where the content should live | ||
|
|
||
| - Prefer updating an existing doc over creating a new one. | ||
| - Place content in the most discoverable location: | ||
| - `README.md`: project entry point and “what is this?”. | ||
| - `docs/`: longer-form docs (follow existing conventions in that tree). | ||
| - Source KDoc: API usage, examples, and semantics that belong with the code. | ||
|
|
||
| ## Follow local documentation conventions | ||
|
|
||
| - Follow `.agents/documentation-guidelines.md` and `.agents/documentation-tasks.md`. | ||
| - Use fenced code blocks for commands and examples; format file/dir names as code. | ||
| - Avoid widows, runts, orphans, and rivers by reflowing paragraphs when needed. | ||
|
|
||
| ## Make docs actionable | ||
|
|
||
| - Prefer steps the reader can execute (commands + expected outcome). | ||
| - Prefer concrete examples over abstract descriptions. | ||
| - Include prerequisites (versions, OS, environment) when they are easy to miss. | ||
| - Use consistent terminology (match code identifiers and existing docs). | ||
|
|
||
| ## KDoc-specific guidance | ||
|
|
||
| - For public/internal APIs, include at least one example snippet demonstrating common usage. | ||
| - When converting from Javadoc/inline comments to KDoc: | ||
| - Remove HTML like `<p>` and preserve meaning. | ||
| - Prefer short paragraphs and blank lines over HTML formatting. | ||
|
|
||
| ## Validate changes | ||
|
|
||
| - For code changes, follow `.agents/running-builds.md`. | ||
| - For documentation-only changes in Kotlin/Java sources, prefer `./gradlew dokka`. | ||
|
|
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,5 @@ | ||
| interface: | ||
| display_name: "Writer" | ||
| short_description: "Write and update user/developer docs" | ||
| default_prompt: "Write or revise documentation in this repository (for example: README.md, docs/**, CONTRIBUTING.md, and API documentation/KDoc). Follow local documentation guidelines in .agents/*.md, keep changes concise and actionable, and include concrete examples and commands where appropriate." | ||
|
|
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,23 @@ | ||
| # Title | ||
|
|
||
| ## Goal | ||
|
|
||
| State what the reader will accomplish. | ||
|
|
||
| ## Prerequisites | ||
|
|
||
| - List versions/tools the reader needs. | ||
|
|
||
| ## Steps | ||
|
|
||
| 1. Do the first thing. | ||
| 2. Do the next thing. | ||
|
|
||
| ## Verify | ||
|
|
||
| Show how the reader can confirm success. | ||
|
|
||
| ## Troubleshooting | ||
|
|
||
| - Common failure: likely cause → fix. | ||
|
|
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,11 @@ | ||
| ````kotlin | ||
| /** | ||
| * Explain what this API does in one sentence. | ||
| * | ||
| * ## Example | ||
| * ```kotlin | ||
| * // Show the typical usage pattern. | ||
| * val result = doThing() | ||
| * ``` | ||
| */ | ||
| ```` |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,13 @@ | ||
| {{< code-tabs langs="Kotlin, Java">}} | ||
|
|
||
| {{< code-tab lang="Kotlin" >}} | ||
| ```kotlin | ||
| ``` | ||
| {{< /code-tab >}} | ||
|
|
||
| {{< code-tab lang="Java" >}} | ||
| ```java | ||
| ``` | ||
| {{< /code-tab >}} | ||
|
|
||
| {{< /code-tabs >}} |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -96,11 +96,14 @@ fun RepositoryHandler.spineArtifacts(): MavenArtifactRepository = maven { | |
| val RepositoryHandler.intellijReleases: MavenArtifactRepository | ||
| get() = maven("https://www.jetbrains.com/intellij-repository/releases") | ||
|
|
||
| val RepositoryHandler.jetBrainsCacheRedirector: MavenArtifactRepository | ||
| get() = maven("https://cache-redirector.jetbrains.com/intellij-dependencies") | ||
|
|
||
| val RepositoryHandler.intellijDependencies: MavenArtifactRepository | ||
| get() = maven("https://packages.jetbrains.team/maven/p/ij/intellij-dependencies") { | ||
| content { | ||
| includeGroupByRegex("com\\.jetbrains\\.intellij.*") | ||
| includeGroupByRegex("org\\.jetbrains\\.intellij.*") | ||
| includeGroupByRegex("com\\.jetbrains.*") | ||
| includeGroupByRegex("org\\.jetbrains.*") | ||
| includeGroupByRegex("com\\.intellij.*") | ||
| } | ||
| } | ||
alexander-yevsyukov marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
|
@@ -129,6 +132,7 @@ fun RepositoryHandler.standardToSpineSdk() { | |
| } | ||
|
|
||
| intellijReleases | ||
| jetBrainsCacheRedirector | ||
| intellijDependencies | ||
|
Comment on lines
+135
to
136
|
||
|
|
||
| maven { | ||
|
|
||
Uh oh!
There was an error while loading. Please reload this page.