[niksirbi]

Ports neuroinformatics-unit/HowTo#78 to this repository, as agreed in #294.

Changes

Same content changes as the source PR, applied to docs/source/howto/programming/SSH-SWC-cluster.md (the _static paths differ here, so this was applied by hand rather than cherry-picked):

• Log into the cluster: distinguish the two scenarios. From within the SWC network (wired connection or VPN) you can ssh to the gateway directly; only from outside do you need to hop through the bastion node.
• "Why do we SSH twice?" → "Types of HPC nodes", with the bastion/gateway/compute distinction presented as a table.
• Windows note, managed-desktops note and SSH config/keys sections updated to match. I removed the explanded flowchart that also included managed machines, because it was getting too complex. The SSH config is still representing the "outside the SWC network" case, as this is were aliases and proxy-jumps are most useful.

Testing

sphinx-build runs clean.

How to review

Instead of inspecting the diff, I recommend rendering the updated guide and reading it as is. Double check it works with the cluster's current configuration.

[IgorTatarnikov]

This looks great, just a few small comments.

The only thing that's blocking is the appearance of the flow chart in dark mode. Is it possible to have a background for the whole figure or create a light and dark version?

[IgorTatarnikov]

LGTM 🎉

Thanks for addressing the comments!