Files
mars-nwe/doc/README.md
2026-06-11 15:19:04 +02:00

1.3 KiB

MARS-NWE documentation

This directory is the project documentation index. Keep the top-level doc/ directory small and put new material into topic subdirectories.

Topics

  • Overview - historical upstream project overview notes.
  • Install - installation notes and platform-specific setup.
  • FAQ and bugs - old FAQs, bug notes, and translated question lists.
  • Features - feature-specific notes such as trustees, PIPE-FS, PPP, file sharing, and NLS.
  • Quota - Linuxquota and NWQUOTA backend design.
  • History - old changelog, news, credits, and package metadata.
  • Packaging - distro packaging snippets kept as references.
  • Man pages - manual pages.
  • Assets - images used by documentation or packaging.
  • Old - legacy build/configuration references. The old BSD/Unix makefile is kept there as historical build reference.

Layout rule

New screenshots and reference captures should live next to the feature they document. For example, FILER or SYSCON screenshots for quota behavior belong under doc/quota/, not directly in doc/.

The old plain-text files are intentionally preserved, but moved into folders so future documentation can grow without making the top-level directory hard to read.