Usability: submitting jobs

[RobJY]

I reviewed the Submitting Jobs section for usability and have the following open questions:

• In both slurm submitting jobs section and the slurm tutorial:
  • array job is using python2 in run-jobarray.s
  • python2_wordcount.py needs to remove the U option from the open file command
  • remove the 2 from python2_wordcountpy filename
• in slurm submitting jobs:
  • xterm doesn't exist on (some/all) compute nodes. In the Interactive Bash Job Examples sections we ask users to verify forwarding is working by calling xterm. What should we use instead?
    • how about gnuplot test
  • make example prompts consistent
  • update GPU examples to our current GPUs
• in slurm tutorial
  • tutorial says to read Slurm Main Commands before tutorial, so should the document order be changed?
  • compiling the MPI example with the intel compiler fails for me, but it works with gcc.
    • looks like there's some version incompatibility so I'm just removing the intel option.
• [ ] I also went through the old tutorials for linux and HPC and they have the same issues with quotes vs. admonitions and calling xterm when it doesn't exist on the server. Should I go ahead and make changes to them as well?
• the following are bigger jobs than I originally thought, so I'll put them in a new PR
  • [ ] replace old tutorials with newer ones
  • [ ] hpc shell
  • [ ] hpc intro
• try adding Mermaid diagrams to tutorials (and to new tutorials that will become a new issue)
  • https://docusaurus.io/blog/releases/3.6#mermaid
  • thanks for the suggestion Sajid!

@s-sajid-ali can we make changes to the files getting copied in for the array job tutorials? Any thoughts on the other open questions or who I should contact about them?

Thanks for the help with these!

[github-actions]

PR Preview Action v1.6.0
🚀 View preview at https://NYU-RTS.github.io/rts-docs-dev/pr-preview/pr-72/
Built to branch gh-pages at 2025-04-03 19:06 UTC. Preview will be ready when the GitHub Pages deployment is complete.

[RobJY]

@s-sajid-ali I'm having trouble getting mermaid installed. I keep getting a conflict between eslint, @eslint/compat, and other packages. Were you able to get it installed and added to this project?