Try   HackMD

UPPMAX website - userguide

Recurring meetings Fridays at 13.15

Meeting

Issues

To determine SiteVision vs MkDocs

General rule

  • Suggestion for overall rule 1
    • Most info on SiteVision

    • All HowTos on MkDocs, example:

      • SiteVision: overview of what we can offer
        • links to project information
      • MkDocs: applying for NIASS projects in
    • YES: BC, RB, ML

    • No: PL

    • PL: I would prefer something like this, clearly defined what category of pages go where. But think many howtos about especially apply for project should be on SV.

What is the guiding premise:

  • Until applying on SiteVision (proj application on MkDocs) - All instructions:
    • [VOTED] BC, DI, ML, RB
  • Until using (including applying) on SiteVision:
    • ?PL

Applying for an account:

  • On SiteVision: ?PL
  • On MkDocs: BC, DI, ML, RB

Applying for NAISS projects:

  • On SiteVision: ?PL
  • On MkDocs: BC, DI, ML, RB

Applying for a local project:

  • On SiteVision: ?PL
  • On MkDocs: BC, DI, ML, RB

PUBA:

  • On SiteVision:
  • On MkDocs: BC, DI, ML, RB, ?PL

Hardware:

  • On SiteVision:
  • On MkDocs:

Instructions about (howto) Services offered through UIT (if a page is needed):

  • On SiteVision:

  • On MkDocs: RB, DI, ML

  • Suggestion for overall rule 2

    • [VOTED]: try hard for minimal duplication
    • Minimize double info
      • [VOTED] Yes: BC, RB, PL
      • No
    • 2b: absolutely no double (no pragmatism)
      • Yes: PL
      • No: BC, RB, PL
    • PL: I vote for both "no pragmatism" sounds a bit harsh, but we should really minimize hard. The end user experience gets confusing when info are in two places - "am I reading in the correct place?" One page would be best. If we need two pages it is good if they are clearly defined to cover different parts, this will also minimize the times you have to jump between the two pages.
  • Suggestion for other alternative rule(s)

    • Extreme MkDocs:
      • everything except links to mkdocs on SiteVision
      • no subpages
    • Almost Extreme MkDocs:
      • keep subpages but only put links here
    • Like today
      • on cluster on MkDocs
      • Project management on SiteVision
    • More SiteVision: PL
      • Some MkDocs content > SiteVision
      • As much as possible on SiteVision
      • Only use mkdocs when we can motivate it
        • dynamic pages (sw list)
        • frequently updates pages - easier on mkdocs(?)
        • lots of code - easier with markdown

Specific topics

  • Log in to each cluster, now at SiteVision And MkDocs

    • SiteVision only:
      • Cons/pros??
    • MkDocs only: BC, RB, PL (if other howtos/userguides are on mkdocs)
    • Both
  • General description of hardware, now at SiteVision and MkDocs

    • [VOTED] SiteVision only: DI, ML, BC
    • MkDocs only: RB
    • Both:
  • Detailed Hardware (how to access), now at SiteVision and MkDocs

  • System usage, now a link from SiteVision to mkdocs

    • Link from SiteVision
    • Link from MkDocs (move):
    • [VOTED] Link from Both: RB, BC, ML, DI
    • PL: this might become problematic on SV in the future if we want to add more, and more dynamic content. job dashbords and such. But we can move to mkdocs later if necessary.
  • Applying for a projects and accounts, now SiteVision

    • Problem today: can be much more pedagocigal in MkDocs
      • PL: "can be much more pedagogical" - how?
    • SiteVision (keep): PL
    • MkDocs (move): RB
    • Both: BC
      • Example:
        • Info about projects in SiteVision
        • How to: in MkDocs, of course with links from SiteVision
  • Our Courses, Now SiteVision

    • https://www.uu.se/en/centre/uppmax/study/courses-and-workshops
    • SiteVision (keep): BC, PL
      • Pro: we can keep the existing formatting
    • MkDocs (move):
      • Pro: Everyone can easily modify their courses. Don't have to bother about swedish + english versions that have to be in phase
        • Example: Singularity was just updated in Eng version
        • However: important to make the existence of courses visible on SV
    • Both: listing courses on SV, course pages on MkDocs
      • [VOTED] BC, RB, DI, ML,

Course registrations:

  • Use SiteVision form for future course registrations:
    • Yes: ML, DI
    • No:
    • Neutral: RB
    • [VOTED] Investigate first, then move to future meeting

SiteVision additions:

  • SV calender/news (courses instance?)

    • Move to later meeting
  • Support on SiteVision (consists of links), now duplicated

    • [VOTED] Keep: PL, BC, ML, DI (and keep what we have on MkDocs)
    • Mkdocs (move): RB
  • Links back?

    • Can links in the mkdocs menu redirect to SiteVision?
    • For example, the Support link at the top could go to support in sitevision
    • Keep things as they are!
  • Björn changes the UPPMAX link name in the menu from "main page"

Meeting 27 Sep 13:15

Status

  • For next week: What is the rule for SiteVision versus MkDocs

    • Advantage SiteVision: inbuilt text-to-speed
      • R: but there are also programs for that ?
    • Advantage MkDocs: all the checks
    • Rule 1: before on the cluster (e.g. apply), on SiteVision
    • Rule 2: before having decided to be a user, on SiteVision. Or: on MkdDocs if possible
  • SiteVision

    • More and more evident that SiteVision needs revision
  • Follow-up

    • Gitlab account for Richel
      • R asks GitLab account to Marcus Lundberg
  • GH-pages

Discussions

  • SiteVision
    • More and more evident that SiteVision needs revision
    • Issues needed, where to put
      • "alias GH repo"?
  • Text to speech
    • R: #117: How important is text-to-speech, contact Marcus Lundberg

Prioritizations

Meeting 13 Sep 13:15

Status

Coming changes

  • Software table update from
    • first: Rocky9 Rackham
    • 2025: Pelle
  • New clusters
    • when time approaches
      • make a branch for the new systems Pelle/Maja?
      • or develop to main: RB (and volunteers)
        • Pelle = new Rackham
        • Maja = new Bianca, re-uses Cygnus storage
        • Gorilla = new storage system, mainly for Pelle

Prioritizations

  • not right now

Meeting 14 June 13.00

Focus on Docs

Meeting May 31

Focus on Docs

Status 31 May

Heading 1 Heading 2 Name Content to start from Responsible
Cluster user guide Install install own software in IG so far (integrate) BC
Snowy portal/slurm gpu snowy in IG so far DI
Bianca portal/slurm gpu bianca no deep docs yet DI
Running jobs display disk quota cluster_guides/old RB (BC solution OK?)
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →
Running jobs Managing module dependencies in IG so far but really old BC
Running jobs Conflicting modules (in runtime tips) in IG so far BC

Still needing formatting on Software May 31 ?

  • allinea ddt F+WebTree,
    • Installing and development/debuggers
  • debuggers and profile gdb F+WT- RB, put under misc
    • Installing and development/debuggers
  • thinlinc - RB, put under misc
    • done?

ToDo:s in June

  • investigate local GitLab

Meeting May 17

Focus on Docs

Status 17 May

Heading 1 Heading 2 Name Content to start from Responsible
Cluster user guide Bianca git on Bianca in IG so far BC
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →
Misc webexport cluster_guides/old BC
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →
Install install own software in IG so far (integrate) BC
Snowy portal/slurm gpu snowy in IG so far DI
Bianca portal/slurm gpu bianca no deep docs yet DI
Running jobs display disk quota cluster_guides/old RB (BC solution OK?)
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →
Running jobs much time left on project in IG so far BC
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →
Running jobs Managing module dependencies in IG so far but really old BC
Running jobs Locale settings (in Runtime tips) in IG so far BC
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →
Running jobs Conflicting modules (in runtime tips) in IG so far BC
Managing your project New page with sub files move some from IG BC
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →
Managing your project some of the above may go here
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →

Still needing formatting on Software May 17 ?

  • allinea ddt F+WebTree,
    • Installing and development/debuggers
  • debuggers and profile gdb F+WT- RB, put under misc
    • Installing and development/debuggers
  • thinlinc - RB, put under misc
    • done?
  • perl needs formatting - Doug
  • conda needs formatting (issue)
    Image Not Showing Possible Reasons
    • The image file may be corrupted
    • The server hosting the image is unavailable
    • The image path is incorrect
    • The image format is not supported
    Learn More →

    done?

Status 3 May and afterwards

Heading 1 Heading 2 Name Content to start from Responsible
Cluster user guide Misc?? UPPMAX in a can in IG so far Remove
Integrate to Bianca sub-pages Bianca more info in IG so far (software) Diana (not needed)
Bianca git on Bianca in IG so far BC
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →
Misc webexport cluster_guides/old Dahlö
Install singularity in IG so far PM
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →
Install spack in IG so far BC
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →
Install install own software in IG so far (integrate) BC
Snowy portal/slurm gpu snowy in IG so far DI
Bianca portal/slurm gpu bianca no deep docs yet Diana
Running jobs disk storage guide cluster_guides/old BC
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →
Running jobs display disk quota cluster_guides/old RB
Running jobs much time left on project in IG so far BC
Running jobs Managing module dependencies in IG so far but really old BC
Running jobs Locale settings (in Runtime tips) in IG so far BC
Running jobs Conflicting modules (in runtime tips) in IG so far BC
Managing your project New page with sub files move some from IG BC
Managing your project some of the above may go here BC

Still needing formatting on Software

gamess-us needs formatting part of web tree - PM

Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →

allinea ddt F+WebTree,
- Installing and development/debuggers
debuggers and profile gdb F+WT- RB, put under misc
- Installing and development/debuggers
gaussian - PM
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →

molcas - PM
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →

thinlinc - RB, put under misc

detachable screen - PM - from IG, to "running jobs"

Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →

perl needs formatting - Doug
conda needs formatting (issue)
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →

wrf -BC
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →

nvidia deep learning - PM
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →

spack BC
Image Not Showing Possible Reasons
  • The image file may be corrupted
  • The server hosting the image is unavailable
  • The image path is incorrect
  • The image format is not supported
Learn More →

  • machine learning + AI
    • created
      Image Not Showing Possible Reasons
      • The image file may be corrupted
      • The server hosting the image is unavailable
      • The image path is incorrect
      • The image format is not supported
      Learn More →
    • whisper goes here
      Image Not Showing Possible Reasons
      • The image file may be corrupted
      • The server hosting the image is unavailable
      • The image path is incorrect
      • The image format is not supported
      Learn More →

Status 2 May

  • Prios in docs to be added by tomorrow Friday:
    • slurm things
      • Queue
    • running jobs
      • Checking and optimizing jobs
        • needs subpages
      • Runtime tips
        • Björn adds some
          Image Not Showing Possible Reasons
          • The image file may be corrupted
          • The server hosting the image is unavailable
          • The image path is incorrect
          • The image format is not supported
          Learn More →

Status 29 April

Status 16 April

  • Missing in documentation from Info Glue. Heading below are from the InfoGlue Tree

Needs formatting!

User guides Cluster

Slurm user guide

Plotting core hours

Compute time policy

Disk storage

Web export

  • Who takes? ???
  • Place?
  • content
  • formatting

Jobstats

detachable screen

transferring files with 2-factor

  • Who takes? Pavlin
  • done

node's own disk

  • Who takes? Björn
  • content
  • formatting

singularity

spack

gpu snowy

(gpu bianca)

  • Who takes? Diana
  • Place?
  • content
  • formatting

User guides software

GAMESS-US

  • Who takes? Lars
  • HTML+md file is in software/directly-from-IG/ and ready to be formatted
  • integrated in formatted

ALLINEA DDT

  • Who takes? Diana
  • HTML+md file is in software/directly-from-IG/ and ready to be formatted
  • images
  • integrated in formatted

Gaussian

  • Who takes? Pavlin
  • HTML+md file is in software/directly-from-IG/ and ready to be formatted
  • integrated in formatted

OpenMolcas

  • Who takes? Lars/Diana
  • HTML+md file is in software/directly-from-IG/ and ready to be formatted
  • integrated in formatted

debuggers and profile gdb

  • Who takes? Björn
  • HTML+md file is in software/directly-from-IG/ and ready to be formatted
  • integrated in formatted
  • Place?

wrf

  • Who takes? Björn
  • HTML+md file is in software/directly-from-IG/ and ready to be formatted
  • integrated in formatted

nvidia deep learning

  • Who takes? Diana
  • HTML+md file is in software/directly-from-IG/ and ready to be formatted
  • Place?
  • integrated in formatted

Decomissioned

deliver

  • decomissioned

grus

  • Decomissioned

FAQ

  • Some can be merged with existing docs
  • Do we want some as quick answers?
  • Which ones in such case
  • Vote with
    Image Not Showing Possible Reasons
    • The image file may be corrupted
    • The server hosting the image is unavailable
    • The image path is incorrect
    • The image format is not supported
    Learn More →

Login problems THIS IS DONE

Running jobs (common problems)

Login problems with sub pages

  • Site vision Björn
  • docs
  • Make link from docs

Projects and accounts with sub pages

  • Site vision Björn
  • docs

Resources with sub pages

  • Site vision Björn
  • docs

Software

Table
  • Site vision
  • docs Dahlö

Meeting Fri 15 March

Meeting Fri 2 Feb 13:30

Meeting Fri 26 Jan 13:30

  • Just some general discussions

Meeting Fri 12 Jan at 13:30

No meeting.

Meeting Tue 9 Jan at 9:15

  • Björn: cluster environments in quickstart containig modules and Slurm

  • There are different ideas what makes a pretty schematical picture. In an earlier meeting, the idea was that Jonas would decide upon a color scheme. Richel now thinks that that is overkill and he suggest the rule 'If you don't like the look of a schemetical picture, just edit it'. People agreed that we should use a more lightweight approach and we discussed in which way to do so:

    • Freely edit
    • Notify the original author after an edit
    • Ask the original author for ideas what to change
  • This differed between team members:

    • Pavlin and Richel are in the 'freely edit' camp; hence you can freely modify their pictures
    • Björn and Jonas prefer to be notified on editr

Status December 2023

  • Aim for getting site ready for 15 Jan
  • New sub-domain
    • docs.uppmax.uu.se
      Image Not Showing Possible Reasons
      • The image file may be corrupted
      • The server hosting the image is unavailable
      • The image path is incorrect
      • The image format is not supported
      Learn More →
      Image Not Showing Possible Reasons
      • The image file may be corrupted
      • The server hosting the image is unavailable
      • The image path is incorrect
      • The image format is not supported
      Learn More →
      Image Not Showing Possible Reasons
      • The image file may be corrupted
      • The server hosting the image is unavailable
      • The image path is incorrect
      • The image format is not supported
      Learn More →
      Image Not Showing Possible Reasons
      • The image file may be corrupted
      • The server hosting the image is unavailable
      • The image path is incorrect
      • The image format is not supported
      Learn More →
      • Informed in JIRA to use this!
    • support.uppmax.uu.se
      Image Not Showing Possible Reasons
      • The image file may be corrupted
      • The server hosting the image is unavailable
      • The image path is incorrect
      • The image format is not supported
      Learn More →
    • help.uppmax.uu.se
      Image Not Showing Possible Reasons
      • The image file may be corrupted
      • The server hosting the image is unavailable
      • The image path is incorrect
      • The image format is not supported
      Learn More →
    • stjälp.uppmax.uu.se
      Image Not Showing Possible Reasons
      • The image file may be corrupted
      • The server hosting the image is unavailable
      • The image path is incorrect
      • The image format is not supported
      Learn More →
      Image Not Showing Possible Reasons
      • The image file may be corrupted
      • The server hosting the image is unavailable
      • The image path is incorrect
      • The image format is not supported
      Learn More →
      Image Not Showing Possible Reasons
      • The image file may be corrupted
      • The server hosting the image is unavailable
      • The image path is incorrect
      • The image format is not supported
      Learn More →
  • Test deploy from own GitLab server
    • GitLab pages

Meeting Fri 22 Dec at 11.00

  • Status
    • BC:
      • databases v1 done
      • most software pages formatted
      • continue format "compiling pages"
  • Discuss
    • mermaid colors: we discussed a procedure to allow us to all agree,
      instead of discussing every little hue every time.
      Jonas seemed most eager to make these color decisions and Richel and
      Pavlin will accept his decisions. Jdddng thongas will join the UPPMAX meeting
      on Tuesday ?10 January and talk with Elisabeth.
      Note that Diana also was working on a color scheme suggestion.
      Jonas will contact Diana and discuss

    • Bianca portal look:

      • .bashrc?
      • links and overview
    • running-first-job > Best practice (demo)

  • ToDos
    • Jonas
      • design
      • talked to Diana and Jessica
    • Björn
      • pages
    • pavlin
      • linux tools from windows
    • Richèl
      • bianca
        • from course

Meeting Fri 15 Dec at 13.30

Meeting Fri 17 Nov at 13.30

  • Overview and staff

    • Site-vision Björn C & Marcus
      • everything except documentaion
      • also Course pages (info and dates and registrations and links to materials)
    • Github pages All
      • documentation
      • software table
    • Software table and its backend ?
      • frontend ?
      • backend ?
  • Status

Needed?

  • Grus user guide (NGI)
    • where?
  • MOLCAS user guide (chem)
    • Lars
  • GAMESS-US user guide (quant chem)
    • Lars
  • Introduction to VTK programming using Python
    • look at infravis (discuss with Anders H?)
    • passé
    • if q:s from user tell about infravis

Meeting Fri 20 Oct at 13.30

Needed?

  • Grus user guide (NGI)
    • where?
  • MOLCAS user guide (chem)
    • Lars
  • GROMACS
    • menu
  • What Perl modules are in the omnibus module perl_modules/5.18.4?
  • What Perl modules are in the omnibus module perl_modules/5.24.1?
    • One page only in menu
  • GAMESS-US user guide (quant chem)
    • Lars
  • Garli user guide
    • not needed
  • Introduction to VTK programming using Python
    • look at infravis (discuss with Anders H?)
  • SGE vs Slurm comparison
    • not needed
  • Starting Integrative Genomics Viewer (IGV) on Rackham/Snowy
    • needed
    • table link or menu
  • Using CRAM to compress BAM files
    • needed
  • Accessing Swegen
    • link from bianca portal
    • in menu for databases

ToDos

  • Look into adding dynamic width to software table. Possibly also for content (mid panel) in general.

Meeting Fri 13 Oct at 13.30

This was a bit interesting: LUNARC docu

  • having buttons for different material specific for the type of user you are
  • New - used before - expert user - developing software

Meeting Fri 6 Oct at 13:30

  • On-boarding Richel

  • Status?

    • Björn started to play with new pages in Site-vision
    • Björn has started "serial compiling page"
      • include make, git etc..?
    • Matias made a lighter style look red>grey
      • software table!
  • Plans on structure:

    • add umbrella page for user installation?
  • Plans software documentation

    • overview with table
      • add the keywords as a list?
        • minst 2 mjukvaror per keyword
    • specific software doc under software
  • ToDos

Pages done or worked on (as seen under Support on old web)

  • Getting started
    • Slurm Diana
    • First log-in to UPPMAX Björn
      • rackham
      • snowy
      • bianca
    • Disk storage guide Marcus (move to Clusters)
    • Apply for a project Marcus
  • Cluster user guide HPC
    • compiling source code Björn
    • MPI and OpenMP user guide Björn
  • workshops and courses
    • workshops and courses Diana

outside the UU structure:

  • Software page Matias, Jonas
    the link out will not work in firefox because of security interactions with linking embeded pages.
    add {:target="_blank"} to the links that link out. To fix the embeded link security issue with frames.
  • Setup Mkdocs insiders Matias
  • Update theme Matias

Meeting Fri 29 sep at 13:30

  • Status?
    • Björn started to play with new pages in Site-vision
    • Matias made a lighter style look red>grey
      • software table!

Meeting Fri 22 Sep at 13:30

  • To discuss?
    • insiders 5$/month
      • ledningsgrupp next Tuesday

On GH

  • new menu
  • some present pages coupled
  • created files to be filled with content
  • mv hardware to site vision

Pages done or worked on (as seen under Support on old web)

  • Getting started
    • Slurm Diana
    • First log-in to UPPMAX Björn
    • Disk storage guide Marcus (move to Clusters)
    • Apply for a project Marcus
  • Cluster user guide HPC
    • compiling source code Björn
    • MPI and OpenMP user guide Björn
  • workshops and courses
    • workshops and courses Diana

outside the UU structure:

  • Software page Matias, Jonas
    the link out will not work in firefox because of security interactions with linking embeded pages.
    add {:target="_blank"} to the links that link out. To fix the embeded link security issue with frames.
  • Setup Mkdocs insiders Matias
  • Update theme Matias

Meeting 8 Sep

  • To discuss
    • who takes what?
      • see list above
    • where to prioritize?
      • see list above

Tree

  • Getting Started:

    • Applying for a Project: getting_started/project_apply.md
    • Logging into Rackham: getting_started/login_rackham.md
    • Logging into Snowy: getting_started/login_snowy.md
    • Logging into Bianca: getting_started/login_bianca.md
    • Running your first job: getting_started/first_job.md
  • Hardware:

    • Overview: hardware/overview.md
    • Clusters:
      • Rackham: hardware/clusters/rackham.md
      • Snowy: hardware/clusters/snowy.md
      • Bianca: hardware/clusters/bianca.md
    • Storage:
      • Crex: hardware/storage/crex.md
      • Domus: hardware/storage/domus.md
      • Castor: hardware/storage/castor.md
      • Lutra: hardware/storage/lutra.md
  • Running Jobs:

    • Slurm: running_jobs/slurm.md
  • Software/:

    • Overview: software/overview.md
    • Software-specific guides
  • Databases

  • "Courses and workshops"

    • Overview of all courses
  • Support: support.md

Meeting 1 Sep

  • incorporate FAQ into the userguide
  • have a search button
  • in-built tags for pages/sections
  • SiteVision lacks some nice features, could not be suitable for code documentation
  • mkdocs or else?
  • menu - location to be decided

Top level categories

Keep in mind a user-oriented logic: welcome, get access, log in, details

  • Landing page

    • menus according to below top-levels
    • big buttons
      • Get started?
      • Cluster guides?
      • Software and databases
      • Courses and workshop
      • Lost credentials
      • Site-vision link
    • Footer
      • links
      • addresses
  • "Get Started" - How to apply, get accounts, basic usage, etc

  • Cluster user guides

    • rackham+snowy
      • descriptive
      • puff
    • bianca
      • puff
    • linux
    • modules here
    • incorporate basic slurm into basic cluster user guide
    • disk usage guide included here
    • basic installation and compiling
  • Courses and workshops

  • "Available Software"

    • structure inherited from /sw/mf tree
    • specific guides etc available here
    • have a link to info about lmod, slurm
  • "Databases"

  • "Other articles"

    • e.g. advanced slurm
    • compiling tips

To be included:

  • Cluster user status
  • links to navigate back and forth between SiteVision and MKDocs

Articles that should be kept in SiteVision:

  • technical info on the hardware
  • info for press
  • info on personnel?
    • wait a bit