Needs instructions about how to deal with "ruff" - pretty much every python-related push always fails checks about git-and-micropython HOT 1 CLOSED

The list of weird and obscure "conventions"

These are pretty much the default rules enforced by black (and now ruff), and are standard to just about every Python project in existence. See https://peps.python.org/pep-0008/

impossible to manually code to

I don't agree, but also the whole point of having "opinionated" formatters like black / ruff is that you don't have to. As already pointed out in micropython/micropython#13433 you should make this run automatically (e.g. on-save hook in your editor, pre-commit for git, etc).

none of those conventions are enforced on any existing code

Would need to see an example of this, as we run the formatter over the entire repo whenever we change config or version of the formatting tool. See e.g. micropython/micropython@bbd8760 for a recent example. Possibly you're not using the right config (or the right tool?)

Pretty much everyone is going to need to run some kind of tool to make code compliant.

Exactly.

Instructions telling us how to do that are needed.

See https://github.com/micropython/micropython/blob/master/CODECONVENTIONS.md#code-auto-formatting

the discussion about "origin" and usernames and example "git remote -v" are vastly too confusing

Unfortunately these are required concepts to contribute to any GitHub project. If you want to learn more, then https://git-scm.com/book/en/v2/ is probably the best place to start, as well as GitHub's quite extensive documentation -- I can't possibly be expected to write a complete guide to git and GitHub, my goal is just to provide a few recipes for the things that people are likely to encounter with our project (although many other projects use a nearly-identical workflow).

we need to be reading step-by-step things

People are welcome to submit PRs with improvements, but unfortunately unless I understand what the issues and conceptual hurdles people are running into it's very difficult to just intuit what exactly you need me to explain. As per
https://github.com/jimmo/git-and-micropython#contributing if the advice here isn't working then please provide information about what you tried, what output you got, etc.

(Just a reminder, this is something I wrote in my spare time)

from git-and-micropython.