This is an automated email from the ASF dual-hosted git repository. dsmiley pushed a commit to branch branch_9x in repository https://gitbox.apache.org/repos/asf/solr.git
commit f534c9aadc55bd3abbd1f87224bddf647457deff Author: David Smiley <[email protected]> AuthorDate: Sat Aug 15 22:00:14 2026 -0400 AGENTS.md JIRA note (#4701) (cherry picked from commit f22b28573fae5d3d2f4b9f3f339dbfbee1af05cb) --- AGENTS.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 46b8c69a2a4..5bf8ba52773 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -8,8 +8,7 @@ While README.md and CONTRIBUTING.md are mainly written for humans, this file is - Always apply the Apache License to new source files - All versions must be delcared in `gradle/libs.versions.toml`, never build.gradle files - Try first declaring a dependency without a version (the version might already be in a BOM); and if fails to resolve _then_ specify a version -- The build may complain with "Dependency analysis found issues.", a category like "usedUndeclaredArtifacts", and a dependency list. Declare or undeclare these dependencies, as the category will imply. The special 'permit*' configurations are a choice of last resort. -- Always run `gradlew updateLicenses resolveAndLockAll --write-locks` after adding or changing a dependency. See `dev-docs/gradle-help/dependencies.txt` for more info +- Always run `gradlew updateLicenses resolveAndLockAll collectJarInfos --write-locks` after adding or changing a dependency. See `dev-docs/gradle-help/dependencies.txt` for more info ## Build and Development Workflow @@ -21,6 +20,8 @@ While README.md and CONTRIBUTING.md are mainly written for humans, this file is - Use the project's custom `EnvUtils` to read system properties. It auto converts env.var SOLR_FOO_BAR to system property solr.foo.bar - Be careful to not add non-essential logging! If you add slf4j log calls, make sure to wrap debug/trace level calls in `logger.isXxxEnabled()` clause - Validate user input. For file paths, always call `myCoreContainer.assertPathAllowed(myPath)` before using +- Never use fully-qualified-names when an import statement will resolve ambiguity. +- SolrJ & "api" modules should use the latest Java 17 language features as appropriate. Other modules can use Java 21. ## Testing @@ -46,3 +47,10 @@ While README.md and CONTRIBUTING.md are mainly written for humans, this file is - We use the "logchange" tooling to manage our changelog. See `dev-docs/changelog.adoc` for details and conventions - To scaffold a new changelog entry, run `gradlew writeChangelog`, and then edit the new file located in `changelog/unreleased/`. - Do not add a changelog entry before a JIRA issue or a Github PR is assigned, as one is required. + +## Issue Tracking (JIRA) + +Solr issues are tracked at https://issues.apache.org/jira (project key `SOLR`). The anonymous REST API works; no auth or scraping needed: + +- Search: `curl "https://issues.apache.org/jira/rest/api/2/search?jql=<url-encoded JQL>&fields=summary,status,resolution&maxResults=10"` with JQL like `project=SOLR AND text~"some phrase" ORDER BY updated DESC` +- Single issue (with comments): `curl "https://issues.apache.org/jira/rest/api/2/issue/SOLR-12345?fields=summary,description,comment"`
