---
title: "Documenting Slice Definitions"
url: https://docs.zeroc.com/ice/3.8/slice/documenting-slice-definitions
docs_index: https://docs.zeroc.com/llms.txt
---

> For an index of every page, see [llms.txt](https://docs.zeroc.com/llms.txt).

# Documenting Slice Definitions

A *doc comment* documents the Slice definition that follows it. Every Slice compiler except `slice2php` and `slice2rb` checks doc comments and maps them into the generated code, using that language's doc-comment conventions, so what you write in Slice also documents the generated API.

Slice supports two [styles](https://docs.zeroc.com/ice/3.8/slice/documenting-slice-definitions/comment-syntax.md) of doc comments and a small set of [tags](https://docs.zeroc.com/ice/3.8/slice/documenting-slice-definitions/doc-comment-structure.md). You can also run [Doxygen](https://docs.zeroc.com/ice/3.8/slice/documenting-slice-definitions/generating-documentation-with-doxygen.md) on your Slice files to generate an API reference for the Slice definitions themselves.
