# New reader finding documentation unnecessarily confusing

**URL:** https://discourse.nixos.org/t/new-reader-finding-documentation-unnecessarily-confusing/40722
**Category:** Documentation
**Created:** [March 3, 2024, 5:45pm UTC](https://discourse.nixos.org/t/new-reader-finding-documentation-unnecessarily-confusing/40722 "2024-03-03T17:45:47Z")
**Posts on this page:** 1
**Showing post:** 1

<div class="post-metadata">

### Author: ![gdennie](https://discourse.nixos.org/user_avatar/discourse.nixos.org/gdennie/32/15551_2.png) [@gdennie](https://discourse.nixos.org/u/gdennie)
#### Post date: [March 3, 2024, 5:45pm UTC](https://discourse.nixos.org/t/new-reader-finding-documentation-unnecessarily-confusing/40722/1 "2024-03-03T17:45:47Z")

</div>

A **glossary** is necessary both for new users dealing with the terminology and intent of conventional phrases as well as for those writing the documentation so that terminology can be kept consistent and well defined throughout.

Case in point is that following the completion of the “hello.nix” packaging tutorial I did not “see” a package. Specifically, instead of one nix file there were two, `default.nix` and `hello.nix`. Alternatively, I suppose the directory tree of `./result/` may constitute the package though I did not expect a directory tree.

Upon reflection, I think the package should probably have been `./hello/default.nix` or `hello.nix` without the effort to conform it to the current convention in `Nixpkgs` which has its own unrelated reasons. In particular, the use of `-A hello` made no sense at this point since `default.nix` already refers to `hello.nix`.

---

_[View the full topic](https://discourse.nixos.org/t/new-reader-finding-documentation-unnecessarily-confusing/40722)._