Hey @wassup05. Thanks for the PR. Great work!

1. I added minor suggestions to the comments (just grammar).
2. For example_remove_directory, I wonder if it makes sense to first create the directory. Ideally an example only demonstrates the use of one procedure, but without the existing directory, it can't. Just a thought and nothing major.

For example_remove_directory, I wonder if it makes sense to first create the directory. Ideally an example only demonstrates the use of one procedure, but without the existing directory, it can't. Just a thought and nothing major.

I think it's fine @sebastian-mutz, doing that would kind of clutter the example I feel, and this is how it's been handled in some other examples as well like here and here

For example_remove_directory, I wonder if it makes sense to first create the directory. Ideally an example only demonstrates the use of one procedure, but without the existing directory, it can't. Just a thought and nothing major.

I think it's fine @sebastian-mutz, doing that would kind of clutter the example I feel, and this is how it's been handled in some other examples as well like here and here

Makes sense. Then it's best to keep it consistent.

Concerning the mode argument which is not applicable to Windows, here is how some other languages handle it...

Python

Complete docs here: https://docs.python.org/3/library/os.html#os.mkdir
To quote some important parts:

On some systems, mode is ignored. Where it is used, the current umask value is first masked out. If bits other than the last 9 (i.e. the last 3 digits of the octal representation of the mode) are set, their meaning is platform-dependent. On some platforms, they are ignored and you should call chmod() explicitly to set them.

On Windows, a mode of 0o700 is specifically handled to apply access control to the new directory such that only the current user and administrators have access. Other values of mode are ignored.

Golang

Golang does it in a different way by creating a portable custom struct of the permission bits, to quote exactly

A FileMode represents a file's mode and permission bits. The bits have the same definition on all systems, so that information about files can be moved from one system to another portably. Not all bits apply to all systems. The only required bit is ModeDir for directories.

Reference: https://pkg.go.dev/os#FileMode, https://pkg.go.dev/os#Mkdir

Rust

Rust seems to have dropped this argument completely and uses default permissions
Reference: https://doc.rust-lang.org/std/fs/fn.create_dir.html

Regarding the mode argument:
It seems like Go's and Rust's handling are more in line with the previously discussed approach of avoiding the consideration of platform specifics by stdlib users. I wonder if Go's struct-based approach could be mirrored in Fortran through derived type. Then again, it's been my experience that "keep it simple now, add complexity later (if needed)" usually creates the fewest headaches down the line. Consequently, I'm leaning towards Rust's very simple approach, but I'm curious what others think.

In absence of further comments, and with two approvals, I will go ahead and merge this one.