Add more docs for Dynamic Profiles

Notably missing:

1. Suggestions on what to name your profile plist file(s?).

2. Is it one or multiple files? The docs aren't clear.

3. Explaining what makes these profiles dynamic, and not just exported profiles in JSON/XML plist formats.

4. Lists of criteria for dynamic switching, including how to define and test the criteria.
   One super useful rule to configure would be checking local .gitconfigs for different users, and changing profiles based on that.

5. What the role of environment variables are with this feature.
   a. Can they be overridden, altered?
   b. What does this mean in the profile plist files? "Set Local Environment Vars" : true
   c. How does sudo su - play into this feature?

6. What role do tags play with Dynamic Profiles? By default, I'm not getting the same UI menu options that others are (e.g. in #3492 (closed)). Note though, that in my case, I compiled iTerm2 myself in an effort to get more padding (as in #3571).

I had to add the "Dynamic" tag to each one to get that same UI, but I don't think the profiles themselves are being treated any differently by the application itself.

Suggestions on what to name your profile plist file(s?).

I don't really have a suggestion, but I'll add a note that it's irrelevant to iTerm2.

Is it one or multiple files? The docs aren't clear.

It's implied in the Minutiae section, but I'll make it clear throughout that it can be one or many.

Explaining what makes these profiles dynamic, and not just exported profiles in JSON/XML plist formats.

I think this is clear from the first paragraph:

Profiles may be changed at runtime by editing one or more plist files…

Lists of criteria for dynamic switching, including how to define and test the criteria. One super useful rule to configure would be checking local .gitconfigs for different users, and changing profiles based on that.

What do you mean by "dynamic switching"? Are you referring to Automatic Profile Switching? (documented here: https://iterm2.com/shell_integration.html)

What the role of environment variables are with this feature. a. Can they be overridden, altered?

Currently there are no settings available to change specific environment variables.

b. What does this mean in the profile plist files? "Set Local Environment Vars" : true

This corresponds to Prefs>Profiles>Terminal>Set locale variables automatically. Sorry for the ambiguity! I do owe the world better docs on the fields in here, but there are so many that I won't be able to get around to it for a while.

c. How does sudo su - play into this feature?

For Automatic Profile Switching, it could if you installed shell integration as root, though I doubt most people would be comfortable doing that.

What role do tags play with Dynamic Profiles? By default, I'm not getting the same UI menu options that others are (e.g. in #3492 (closed)). Note though, that in my case, I compiled iTerm2 myself in an effort to get more padding (as in #3571).

I'll update the docs to indicate that the Dynamic tag gets added automatically. And you can define a profile's tags in a dynamic profile, of course.

Thanks so much, George. Let me know if I can make anything clearer.

I can't seem to get the automatic profile switching to work. Can you post a gif or screencast of how it should look in the docs?

The most common reason why APS doesn't work is because you haven't installed shell integration everywhere. For example, if you want to switch profiles when you ssh to example.com, make sure to install shell integration both locally and in your user account on example.com (just log in to example.com and do the install process).