We use GitHub Issues to both onboard and offboard employees to OST and projects within OST. Employee profiles are tracked using GitHub Issues, and new profiles can be added by navigating to the Profile Template. Follow the instructions below to navigate creating a new profile and onboarding and offboarding employees to different divisions and projects.
Onboarding
flowchart TD;
A(["Navigate to Issues"]) --- A0(("Branch Director")) & A1(("New Employee")) & PL(("Project Lead"));
A0 --> B(["Create a new Issue using 'Add new profile' issue type"]);
A1 ----> G["Read through Getting Started Instructions"];
B --> C(["Follow instructions in the Issue"]);
C --> E["Assign Issue to Onboardee"];
PL --> D["Add project specific command (e.g., comment /onboard-FIMS)"];
G --> new("Navigate to your profile Issue and complete tasks or comment on the issue to get help when you reach roadblocks");
new --> F["Complete all assigned tasks"];
E ---> H["Direct employee to this site"];
E@{ shape: lin-rect};
D@{ shape: lin-rect};
F@{ shape: dbl-circ};
H@{ shape: div-rect};
style A fill:transparent;
style A0 fill:#BBDEFB;
style A1 fill:#C8E6C9;
style PL fill:#F54927,fill:#E1BEE7,color:none;
style B fill:#BBDEFB;
style G fill:#C8E6C9;
style C fill:#BBDEFB;
style E fill:#FFE0B2;
style D fill:#E1BEE7;
style new fill:#C8E6C9;
style F fill:#D50000;
style H fill:#FFCDD2;
click A "https://github.com/nmfs-ost/on-off-boarding/issues";
click A0 "https://github.com/nmfs-ost/on-off-boarding/issues/new?template=add_new_profile.yml";
click G "/getting-started.qmd";
Slash commands
Once a profile is created, an onboardee can be onboarded to a division or a project through the use of slash commands in Issue comments. When an Issue comment is started with, or only contains, a forward slash followed by βonboard-*β, where the star must be replaced with a project name, e.g.,β/onboard-sisβ, a task list will appear in the Issue with instructions and checkboxes for either the Onboardee, Project Lead, or Division Director to complete. These tasks lists are stored in the .github/workflows/ directory as .yml files. All task lists related to onboarding start with onboard and all task lists related to offboarding start with offboard. The filename without the extension reflects the name of the slash command.
If a new slash command is created, the command must have its own .yml file and the command must be listed in .github/workflows/slash-command-dispatch.yml. A big thank you to Peter Evans for creating slash command dispatch and maintaining it for us all to use.
Offboarding
flowchart TD;
A(["Navigate to Issues"]) --- A0(("Branch Director")) & A1(("Employee"));
A0 --> B(["Execute command for offboarding from team and/or project"]);
A1 ----> G["Read through offboarding task list"];
B --> E["Reassign Issue to offboardee"];
G --> F["Check off each task after it is completed"];
E --> H["If employee is leaving ST4 and all offboarding tasks are complete, close out their profile"]
E@{ shape: lin-rect};
F@{ shape: dbl-circ};
H@{ shape: div-rect};
style A fill:transparent;
style A0 fill:#BBDEFB;
style A1 fill:#C8E6C9;
style B fill:#BBDEFB;
style G fill:#C8E6C9;
style E fill:#FFE0B2;
style F fill:#D50000;
style H fill:#FFCDD2;
click A "https://github.com/nmfs-ost/on-off-boarding/issues";
Only projects that are associated with a GitHub repository are listed in the table below. There is an additional list of projects on the home page which includes projects that do not have associated GitHub repositories.
Download the latest version of RStudio from Positβsdownload page #### Visual Studio Code
Visual Studio Code (VS Code) is an Electron app that is meant to facilitate coding in any language. To download the latest version navigate to their download page and follow the instructions specific to your operating system.
π¬ AI Resources at NOAA Fisheries
Important
AI tools are currently under pilot use and only some users have access to GitHub copilot.
