Merge pull request #22284 from docker/published-update

publish updates from main

Author: sarahsanders-docker

content/reference/api/hub/deprecated.md

@@ -2,6 +2,7 @@
 description: Docker Hub API v1 (deprecated)
 keywords: kitematic, deprecated
 title: Docker Hub API v1 (deprecated)
+weight: 3
 aliases:
   - /docker-hub/api/deprecated/
 ---

content/reference/api/hub/dvp.md

@@ -3,4 +3,5 @@ layout: api
 description: Reference documentation and Swagger (OpenAPI) specification for the Docker Verified Publisher API.
 linkTitle: DVP Data API
 title: Docker Verified Publisher API reference
+weight: 4
 ---

content/reference/api/hub/latest-changelog.md

@@ -0,0 +1,19 @@
+---
+description: Docker Hub API Changelog
+keywords: hub, api, changelog
+title: Docker Hub API Changelog
+keywords: docker hub, whats new, release notes, api, changelog
+weight: 2
+toc_min: 1
+toc_max: 2
+---
+
+Here you can learn about the latest changes, new features, bug fixes, and known
+issues for Docker Service APIs.
+
+## 2025-03-18
+
+### New
+
+- Add access to [audit logs](/reference/api/hub/latest/#tag/audit-logs) for org
+  access tokens.

content/reference/api/hub/latest.md

@@ -3,4 +3,5 @@ layout: api
 description: Reference documentation and OpenAPI specification for the Docker Hub API.
 title: Docker Hub API reference
 linkTitle: Docker Hub API
+weight: 1
 ---

content/reference/api/hub/latest.yaml

@@ -3,7 +3,7 @@
 openapi: 3.0.3
 info:
   title: Docker HUB API
-  version: beta
+  version: 2-beta
   x-logo:
     url: https://docs.docker.com/assets/images/logo-docker-main.png
     href: /reference
@@ -20,6 +20,10 @@ servers:
     x-audience: public
     url: https://hub.docker.com
 tags:
+  - name: changelog
+    x-displayName: Changelog
+    description: |
+      See the [Changelog](/reference/api/hub/latest-changelog) for a summary of changes across Docker Hub API versions.
   - name: resources
     x-displayName: Resources
     description: |
@@ -400,6 +404,8 @@ paths:
       summary: List audit log actions
       description: |
         List audit log actions for a namespace to be used as a filter for querying audit log events.
+
+        <span class="oat"></span>
       operationId: AuditLogs_ListAuditActions
       security: 
         - bearerAuth: []
@@ -489,7 +495,10 @@ paths:
   /v2/auditlogs/{account}:
     get:
       summary: List audit log events
-      description: List audit log events for a given namespace.
+      description: |
+        List audit log events for a given namespace.
+
+        <span class="oat"></span>
       operationId: AuditLogs_ListAuditLogs
       security:
         - bearerAuth: []
@@ -2992,6 +3001,7 @@ components:
 x-tagGroups:
   - name: General
     tags:
+      - changelog
       - resources
       - rate-limiting
       - authentication

content/reference/compose-file/develop.md

@@ -102,6 +102,25 @@ The syntax is the same as `.dockerignore` file:
 If the build context includes a `.dockerignore` file, the patterns in this file is loaded as implicit content
 for the `ignores` file, and values set in the Compose model are appended.
 
+#### `include`
+
+It is sometimes easier to select files to be watched instead of declaring those that shouldn't be watched with `ignore`.
+
+The `include` attribute can be used to define a pattern, or a list of patterns, for paths to be considered for watching.
+Only files that match these patterns will be considered when applying a watch rule. The syntax is the same as `ignore`.
+
+```yaml
+services:
+  backend:
+    image: example/backend
+    develop:
+      watch: 
+        # rebuild image and recreate service
+        - path: ./src
+          include: *.go  
+          action: rebuild
+```
+
 #### `path`
 
 `path` attribute defines the path to source code (relative to the project directory) to monitor for changes. Updates to any file