Update usage guide to mention github.actor instead of the legacy approaches

[kittydoor]

Related to nektos/act#2115

[ChristopherHX]

On the other hand, the string nektos/act in github.actor is causing bugs.

The slash has to be deleted from the actor context in my opinion, prior documenting such a way to skip steps. Due to me thinking documenting this, make the bar higher for that bug to get ever fixed

The slash is problematic, because programs parsing the actor expect no slash anywhere

[kittydoor]

Tbh, I was thinking of that when I was writing this too. Normally, actor should be a username which means there's a clear character set allowed by GitHub. The slash violates that, and if people are inserting it into places and doing funky things like for example using it in the filename, things can go horribly wrong.

Can we change the value to something else quickly (and make a new major release due to backwards compatibility)? I'm not sure what would be best, since you don't want a collision with an actual username. Then we can also update and merge this PR, and get people using something more reliable going forward.

[kittydoor]

Interesting discovery (while trying to figure out why the docs are lying to me about how to pass secrets to reusable workflows, I came across this): dependabot/dependabot-core#3253 (comment)

The github.actor for dependabot is dependabot[bot]

Snippet from the link above

jobs:
  do-stuff:
    runs-on: ubuntu-latest
    if: ${{ github.actor == 'dependabot[bot]' }}
    steps:
      - uses: actions/checkout

Perhaps for act we could do something like act[local], and avoid username conflicts but still enable for a unique identifier.

[ChristopherHX]

How do you think your proposal would work to detect act if you do

act --actor "dependabot[bot]"

?

In some scenarios it might be required that the actor is correctly set, but still steps should be skipped on act

This would be resolved by just not deleting old content that is more stable regarding this aspect

[Dr-Electron]

Why not make github.event.act true by default? The same way you have an env ACT you could have this true by default. So people don't need an event file. Btw can somebody mark the original issue as non stale?

[jsoref]

Suggested change

	You can take advantage of the github.actor context property, which is normally the user who initiated the workflow. Act sets this to 'nektos/act'.
	You can take advantage of the github.actor context property, which is normally the user who initiated the workflow. Act sets this to `nektos/act`.

[jsoref]

I'm inclined to favor:

1. Changing the act system to default to act[local] (or something like that)
2. Instead of removing the old content, change it to say something like:

   If you are using --actor ... and need to skip certain steps, you can do: