# Langref misc fix and improvement \(\#14695\) · gitcafe/zig

[View on GitCafe](https://git.cafe/gitcafe/zig/commit/366e3c657fe7d898465a0e822f1999f0572f832e)

Repository: [gitcafe/zig](https://git.cafe/gitcafe/zig)

Visibility: public

Requested revision: 366e3c657fe7d898465a0e822f1999f0572f832e

Requested commit: 366e3c657fe7d898465a0e822f1999f0572f832e

Commit: 366e3c657fe7d898465a0e822f1999f0572f832e

Tree: 51e5f36f48d9d9612b71236526c2328b515ddf8c

Author: Manlio Perillo

Committer: GitHub

## Message

```
Langref misc fix and improvement (#14695)

* langref: improve the Hello World section

Clarify that a Zig source file must have the .zig extension.

Fix a typo.

* langref: improve the Comments section

  - Document how doc comments are used by -femit-docs
  - Rename "Doc comments" to "Doc Comments", for consistency
  - Clarify that placing a doc comment in an unexpected place is a
    compiler error and add two incorrect examples
  - Document the current Autodoc behavior, when normal comments are
    interleaved with doc comments
  - Rewrite the documentation for top-level doc comments

* langref: improve the Zig Test section

Document that the test name can also be an identifier, in addition to a
string literal.

Update the test output for the first test.

Closes #14085
```

## Parents

- [6e84f469904a24615a6721265a88ad8dcb4ed83a](https://git.cafe/gitcafe/zig/commit/6e84f469904a24615a6721265a88ad8dcb4ed83a?format=markdown)

[Source at this commit](https://git.cafe/gitcafe/zig/tree/366e3c657fe7d898465a0e822f1999f0572f832e?format=markdown)