Update README.md - Version 0.3.0

Author: aafulei

README.md

@@ -8,23 +8,34 @@
 
 *A minimal but complete Make-based C++23 project template.*
 
-This project packages a simple C++23 command-line program, including essential
-tools and workflows for building, testing, and maintaining the code. The
-program prints the current date in the `YY/MM/DD = Www` format (e.g., `25/05/14
-= Wed`).
+This project packages a simple C++23 command-line program with essential tools
+and workflows for building, testing, and maintaining the code. The program
+prints the current date in the `YY/MM/DD = Www` format (e.g. `25/05/14 = Wed`).
 
 Project website:
 [**aafulei.github.io/cpp-today**](https://aafulei.github.io/cpp-today).
 
+- [Features](#features)
+- [Supported Platforms](#supported-platforms)
+- [Getting Started](#getting-started)
+- [Project Structure](#project-structure)
+- [Project Website](#project-website)
+- [Author](#author)
+- [License](#license)
+- [Version](#version)
+- [Changelog](#changelog)
+
 ## Features
 
 - Minimal, complete C++23 project template
-- Simple and reliable Make-based build system
+- All-in-one Make-based build system
 - Test scripts for manual and automated testing
 - Code formatting support with Clang Format
 - Editor tooling support via Clangd
 - Built-in CI/CD workflows using GitHub Actions
-- Project documentation website generated with MkDocs
+- Project documentation website built with MkDocs
+- Source code documentation generated with Doxygen
+- Software documentation in GNU-style man page
 
 ## Supported Platforms
 
@@ -35,14 +46,15 @@ Project website:
 
 ### Download
 
-Download pre-built binaries from the
-[Release](https://github.com/aafulei/cpp-today/releases)
-page (or build from source as shown below).
+Download pre-built binaries and the accompanying man page from the
+[Release](https://github.com/aafulei/cpp-today/releases) page.
+
+Alternatively, you can build the program from source as shown below.
 
 ### Build
 
-Clone the [GitHub repository](https://github.com/aafulei/cpp-today). Use `make`
-to build the program:
+Clone the [GitHub repository](https://github.com/aafulei/cpp-today). Then use
+`make` to build the program:
 
 ```shell
 make
@@ -51,61 +63,107 @@ make
 ### Run
 
 - If you downloaded the binary from the
-[Release](https://github.com/aafulei/cpp-today/releases)
-page, follow the instructions there.
+[Release](https://github.com/aafulei/cpp-today/releases) page, follow the
+instructions there.
 
-- If you built it yourself using `make`, run the executable located at:
+- If you built the program yourself using `make`, you can run it with:
+
+    ```shell
+    make run
+    ```
+
+    Alternatively, to run manually:
+
+    ```shell
+    ./bin/release/today
+    ```
+
+You should see the current date printed out in the `YY/MM/DD = Www` format, for
+example:
 
-```shell
-./bin/release/today
 ```
+25/05/14 = Wed
+```
+
+### Install
 
-Alternatively, you can build and run the program in one step:
+To install the program, run:
 
 ```shell
-make run
+make install
 ```
 
-### Result
+The `man` page will be installed alongside the program. You might need `sudo`
+privileges. Run `make help` for customization options. To install the
+binary and the man page manually, copy them to their default destinations or to
+directories of your choice:
 
-You should see the current date printed out in the `YY/MM/DD = Www` format, e.g.
+| Source                | Default Destination          |
+| --------------------- | ---------------------------- |
+| `./bin/release/today` | `/usr/local/bin/`            |
+| `./docs/man/today.1`  | `/usr/local/share/man/man3/` |
 
-```
-25/05/14 = Wed
+To uninstall the program and the man page, run:
+
+```shell
+make uninstall
 ```
 
-## Build System
+### Ask for Help
 
-This project features a simple and reliable Make-based build system that allows
-you to use `make` to build, run, and test the program.
+As is typical with command-line programs, run:
 
 ```shell
-make             # Build release version
-make debug       # Build debug version
-make run         # Build and run release version
-make run-debug   # Build and run debug version
-make test        # Build and test release version
-make test-debug  # Build and test debug version
-make clean       # Remove build files
+today --help
 ```
 
-To list all targets and options, run `make help`.
+for help. If the man page has been installed, you can run:
+
+```shell
+man today
+```
+
+to view the manual page for more information.
+
+*For detailed user guides, please visit the project website
+ [**aafulei.github.io/cpp-today**](https://aafulei.github.io/cpp-today).*
 
 ## Project Structure
 
-- [`.github/workflows/`](./.github/workflows/) – GitHub Actions workflows
-- [`docs/`](./docs/) – documentation files for MkDocs and Doxygen
-- [`src/`](./src/) – source code
-- [`tests/`](./tests/) – test scripts
-- [`.clang-format`](./.clang-format) – Clang Format configuration
-- [`.gitignore`](./.gitignore) – Git ignore patterns
-- [`Doxyfile`](./Doxyfile) – Doxygen configuration file
-- [`DoxygenLayout.xml`](./DoxygenLayout.xml) – Doxygen website layout
-- [`LICENSE`](./LICENSE) – software license
-- [`Makefile`](./Makefile) – Make build script
-- [`README.md`](./README.md) – repository documentation (this file)
-- [`compile_flags.txt`](./compile_flags.txt) – Clangd compile options
-- [`mkdocs.yml`](./mkdocs.yml) – MkDocs project website configuration
+- [`.github/workflows/`](./.github/workflows/) — GitHub Actions workflows
+- [`docs/`](./docs/) — project documentation files and assets
+    - [`css/`](./docs/css/) — custom CSS files for MkDocs and Doxygen
+    - [`img/`](./docs/img/) — image files
+    - [`man/`](./docs/man/) - man page files
+    - [`mermaid/`](./docs/mermaid/) - source files for Mermaid diagrams
+    - `.md` files - source files for MkDocs to generate the project website
+- [`src/`](./src/) — source code
+- [`tests/`](./tests/) — test scripts
+- [`.clang-format`](./.clang-format) — Clang Format configuration
+- [`.gitignore`](./.gitignore) — Git ignore patterns
+- [`CHANGELOG.md`](./CHANGELOG.md) — changelog
+- [`Doxyfile`](./Doxyfile) — Doxygen configuration file
+- [`DoxygenLayout.xml`](./DoxygenLayout.xml) — Doxygen website layout
+- [`LICENSE`](./LICENSE) — license file
+- [`Makefile`](./Makefile) — Make build script
+- [`README.md`](./README.md) — repository documentation (this file)
+- [`VERSION`](./VERSION) - version file
+- [`compile_flags.txt`](./compile_flags.txt) — Clangd compile options
+- [`mkdocs.yml`](./mkdocs.yml) — MkDocs project website configuration
+
+## Project Website
+
+![](./docs/img/project.png)
+
+As illustrated in the above diagram, information about this project is presented
+to users and developers in three distinct locations, each serving a specific
+purpose:
+
+| Location                                                                  | Provides                              |
+| ------------------------------------------------------------------------- | ------------------------------------- |
+| [GitHub repository](https://github.com/aafulei/cpp-today)                 | source code and project configuration |
+| [MkDocs website](https://aafulei.github.io/cpp-today)                     | detailed users guides                 |
+| [Doxygen documentation](https://aafulei.github.io/cpp-today/doxygen/html) | detailed code reference               |
 
 ## Author
 
@@ -117,7 +175,7 @@ MIT
 
 ## Version
 
-0.2.0
+0.3.0
 
 ## Changelog