# docs-quarkus-extension **Repository Path**: mirrors_couchbase/docs-quarkus-extension ## Basic Information - **Project Name**: docs-quarkus-extension - **Description**: Couchbase Java SDK Quarkus extension docs (asciidoc) - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: release/1.3 - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-02-16 - **Last Updated**: 2026-05-23 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README = Couchbase Java SDK - Quarkus Extension Documentation This repository hosts the documentation source for the https://docs.couchbase.com/quarkus/1.2/ROOT/overview.html[Couchbase Java SDK Quarkus Extension]. This branch documents the 1.3 release of the Extension, which follows the 3.10.1 release of the Java SDK, which in turn follows the https://docs.couchbase.com/java-sdk/3.9/project-docs/compatibility.html#api-version[SDK 3.8 API]. == Contributing Contributions are welcome! Please test them locally, and then submit a pull request. A guide to using asciidoc, building Antora locally, and working with our repos can be found at https://docs.couchbase.com/home/contribute/index.html[https://docs.couchbase.com/home/contribute/index.html] (this may still be in the middle of being updated). At a minimum, to build the docs locally, you will need this repo, the https://github.com/couchbase/docs-sdk-java[Java SDK repo], https://github.com/couchbase/docs-sdk-common[docs-sdk-common], and the https://github.com/couchbase/docs-server[Server Docs repo] in your Antora playbook. If you are not sure the best way to update the docs, please raise a GitHub issue. == Notes for Docs Maintainers This docset sits alongside the Java SDK docs. The philosophy behind the SDK docs' Information Architecture can be found in the https://docs.couchbase.com/java-sdk/3.9/project-docs/metadoc-about-these-sdk-docs.html[meta doc]. === Directory Structure Antora modules used are as follows: * devguide/examples -- the home of all code examples. * ROOT -- contains `nav.adoc`, the navigation file for this component, and a `pages` subdir with all of the docs content.. Occasionally, a partial fragment in a `partials` directory contains content reused over more than one page. Most re-use is from single-sourced content in the https://github.com/couchbase/docs-sdk-common[sdk-common] repo, but you will currently find little of that here. Partials may also be pulled in from the Java SDK. === Single-sourced Content To make maintenance easier for docs of around a dozen SDKs, content that is common across SDK docsets is -- wherever possible -- single-sourced from the https://github.com/couchbase/docs-sdk-common[sdk-common] repo. This special repo also contains a small amount of such includes. We recognise that this adds a slight cognitive burden for the new maintainer, but one layer of abstraction seems a reasonable compromise for maintainability. To make content re-use workable, certain replaceable attributes are used. These are found in the antora.yml file. .Attributes for Single-sourced Content |=== | Attribute | Use | `server_version:` | SDK dotminor releases contain new APIs to match new Server releases. This is the release version of Couchbase Server that this SDK release accompanied. Not often needed within the SDK documentation -- the server version in `xref` links is set with `version-server:` (see below). | `quarkus_version:` | Sets the current patch version. | `sdk_current_version:` | Sets the current patch version of the Java SDK. | `sdk_dot_minor:` | The current Java SDK dotminor. | `sdk_dot_major:` | The current Java SDK major release -- not often needed within the documentation. | `version-server:` | This is substituted into `xref` links to the Server, to ensure they land on the correct release version. | `version-common:` | The version (branch) of the single-sourced `sdk-common` repo. This is substituted into Antora `include::` directives, to pull in content from the correct branch. | `name_platform:` | Allows us to name the SDK within shared content (*Java*). | `name-sdk:` | Allows us to name the SDK within shared content (*Quarkus SDK extension*). | `sdk_api:` | The API version of this release. | `sdk-api-link:` | Link to the latest API Reference for the SDK. | `sdk-gh-link:` | Link to the source code of the SDK. |=== An additional attribute, `page-nav-header-levels: 1`, ensures that the left-hand navigation of the site opens with each topic unfurled by one level. === Page Headers Each `.adoc` page contains information in the headers: [source,asciidoc] ---- = Compatibility :description: Platform compatibility, and features available in different SDK versions, and compatibility between Server and SDK. \ Plus notes on Cloud, networks, and AWS Lambda. :page-aliases: ROOT:overview,ROOT:compatibility-versions-features,compatibility-versions-features :page-toclevels: 3 :table-caption!: ---- The `:page-aliases:` directive enables Antora to build 502 redirects -- meaning that inbound links from, for example, old blog posts will still work with the current docset. `:page-toclevels:` should be set to `2` to include h3 headers along with h2s in the in-page navigation (right-hand nav). Leaving out this directive means that the page will default to `1`, showing only h2 headers in the in-page nav. A value of `3` should not be used, save in exceptionally complicated pages like that shown (the https://docs.couchbase.com/scala-sdk/1.6/project-docs/compatibility.html[compatibility page]). === Patch Releases Update the following files: * antora.yml * modules/devguide/examples/java/pom.xml * modules/ROOT/pages/quarkus-extension-release-notes.adoc === New Branches Production branches use the *release/x.y* naming pattern (e.g. `release/1.7`, `release/1.6`). Antora uses the branch names in the playbook, but also uses the `version` given in the antor.yml file, to create the version navigation -- so this version number must be unique within the repo for any branches included in the playbook. When creating a new branch for a new release, remember to update the antora.yml file before trying to build. === Code Sample Testing This is in the process of being changed -- documentation will appear here once this is completed. == Docs License ©2026 Couchbase, Inc. This work is licensed under https://creativecommons.org/licenses/by-nc-sa/4.0/[CC BY-NC-SA 4.0].