// Copyright (C) 2025 Gradle, Inc.
//
// Licensed under the Creative Commons Attribution-Noncommercial-ShareAlike 4.0 International License.;
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      https://creativecommons.org/licenses/by-nc-sa/4.0/
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

[[tags_reference]]
= Tags Used in Best Practices

Here you can find a brief explanation of all the tags used in the best practices documentation.

[[tag:caching]]
`#caching` :: Items that are related to using Gradle's various caching mechanisms, such as <<build_cache.adoc#sec:task_output_caching,caching tasks>>.

[[tag:dependencies]]
`#dependencies` :: Items that are related to <<dependency_resolution.adoc#dependency-resolution-basics,dependency resolution>> in Gradle, including declaring dependencies, dependency management, and dependency resolution.

[[tag:inputs-and-outputs]]
`#inputs-and-outputs`:: Items that are related to Gradle <<writing_tasks.adoc#task_inputs_and_outputs,task inputs and outputs>>, the annotations used to declare them, and their proper use.

[[tag:plugins]]
`#plugins` :: Items that explain the proper way to <<custom_plugins.adoc#custom_plugins,write plugins>> in Gradle, and common footguns involved in plugin authoring.

[[tag:tasks]]
`#tasks` :: Items that explain the proper way to <<writing_tasks.adoc#sec:sample_task,write tasks>> in Gradle, and common footguns involved in task authoring.

[[tag:structuring-builds]]
`#structuring-builds` :: Items that explain the proper way to <<multi_project_builds.adoc#multi_project_builds,structure maintainable builds>> in Gradle.

[[tag:kotlin-dsl]]
`#kotlin-dsl` :: Items that explain the benefits of using the <<kotlin_dsl.adoc#kotdsl:kotlin_dsl,Kotlin DSL>> and how to adopt it effectively.

[[tag:up-to-date-checking]]
`#up-to-date-checking` :: Items that are related to Gradle's <<incremental_build.adoc#sec:how_does_it_work,up-to-date checking>> mechanism, and how to ensure work avoidance behaves properly in your build.

[[tag:upgrades]]
`#upgrades` :: Items that are related to making Gradle version upgrades easier.

[[tag:version-catalog]]
`#version-catalog` :: Items that explain how to use <<version_catalogs.adoc#version-catalog,version catalogs>> to centralize dependency declarations.

[[tag:properties]]
`#properties` :: Items that are related to defining and using <<build_environment.adoc#build_environment,build properties>>, such as those in `gradle.properties`, environment variables, or passed via the command line.
