Add description of macros and symlinks. (#559)

* Added section to macros guide describing symlinks. Wording?

* Applied sean's patch.

* Windows instructions

* rm -fn

---------

Co-authored-by: Sean Mann <sean@comcode.org>

Author: jckirton

docs/guides/new_players/macros.mdx

@@ -48,3 +48,68 @@ To delete an existing macro, type `/macro =` with nothing after the `=`.
 >>/bal =
 Macro deleted.
 ```
+
+## Macro storage on disk
+
+### What's a macro file?
+
+Macros in hackmud are stored in a file per user, which is located in the same place as `shell.txt`.
+
+> Run ((%C#dir%)) and go two folders up. Or navigate to:
+>
+> > Windows - `C:\Users\USERNAME\AppData\Roaming\hackmud`\
+> > macOS - `~/.config/hackmud`\
+> > Linux - Either `~/.config/hackmud` or the game folder.
+
+The naming scheme is `username.macros`, and are plain text files.
+
+### Workaround: Sharing macros between users
+
+Because macros are scoped to users by default, when you switch to another user, you can't use the first user's macros.
+
+One of the ways you can solve this is with the concept of a symlink: https://en.wikipedia.org/wiki/Symbolic_link
+
+By adding a symlink to a source file for macros, each user would be editing and reading from the same file, allowing macros to be shared between users.
+
+:::warning
+When mucking with files always back them up before accidentally doing destructive actions.
+:::
+
+#### How to set up a symlink on Windows
+
+Windows 10 and later have access to `mklink`: https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/mklink
+
+Here's an example of mapping / copying macros from user_a's macros to user_b's macros.
+
+:::note
+Running mklink requires a windows command prompt which has been started with administrator permissions.
+:::
+
+```
+USAGE:
+mklink abs_path_to_new_link_file file_path_to_link_to
+
+COMMAND:
+mklink "C:\Users\southr6\AppData\Roaming\hackmud\user_b.macros" "C:\Users\southr6\AppData\Roaming\hackmud\user_a.macros"
+```
+
+#### How to set up a symlink on macOS & linux
+
+To make a symlink these unix-based platforms, we're going to use the `ln` command.
+
+:::note
+Syntax may differ depending on your OS, check `man ln` for usage differences.  
+Also note, the parameters are in different orders in windows and unix.
+:::
+
+We want to run `ln` with the `-s` options, with the source file being the path to the file containing the macros, and the target file being the path to the `username.macros` in the previously mentioned directory.
+
+For example on macOS, my ln usage and command looked like this:
+
+```
+USAGE:
+ln [options] source_file new_link_file
+
+COMMAND:
+ln -s ~/Developer/hackmud/southr6/workshop/macros.txt ~/.config/hackmud/southr6.macros
+```