run GitHub actions locally using gh act

[dimpase]

document how to run GitHub actions locally using gh and docker

gh has an extension called act, which allows to run Actions locally (subject to the usual Docker restrictions, e.g. no macOS on Linux)

Still it's very useful, e.g. for debugging purposes.

[tobiasdiez]

LGTM! Is there a reason why this is marked as draft?

[mkoeppe]

I think the new section is misplaced here - this file has the basic steps of working with GitHub.

Perhaps move it to portability_testing.rst or tools.rst, or a new file

[dimpase]

it's a draft cause I meant to add more details, and indeed to see where it should be. This is about working with GitHub data, and gh tool. Although the latter is not crucial, as act may be installed stand-alone and used without gh, on one hand. On the other hand it's (mostly) portability testing. How about leaving a part as it is now, and move more testing-specific part to portability_testing ?

[dimpase]

tested with gh act -p false -r -j lint-rst - in accordance with https://en.wikipedia.org/wiki/Eating_your_own_dog_food

[mkoeppe]

I think it would be better to give an example that actually exists (and ideally also include that in the above gh act -l output)

[mkoeppe]

I think PDF docs won't build because of the emojis such as 🚀

[dimpase]

yeah, and probably there is no TeX font to use for these. High time we switch to LuaTeX... Has anyone tried?

[dimpase]

OK, I tested pdf docbuild, it works now

[mkoeppe]

LGTM

[github-actions]

Documentation preview for this PR (built with commit 6a6e5ec; changes) is ready! 🎉

[kwankyu]

Thanks. LGTM.