Onboarding post

entries/create-puml-images.md

@@ -3,6 +3,11 @@ title: Creating PlantUML images
 date: last-modified
 ---
 
+On the Seedcase Project website, we use [PlantUML](https://plantuml.com) to create diagrams, such as:
+
+1. [C4 diagrams](https://c4model.com) to visualise the software architecture.
+2. [Sequence diagrams](https://plantuml.com/sequence-diagram) that visualise a how - and in what order - e.g., the user, web interface, api, and backend work together.
+
 To create or regenerate the PlantUML files, run the command:
 
 ``` bash

entries/onboarding.md

@@ -0,0 +1,53 @@
+---
+title: Onboarding
+date: last-modified
+---
+
+{{< include /includes/_wip.qmd >}}
+
+## Welcome to Seedcase
+
+If you landed on this post, you are most likely a new team member on the Seedcase project. Welcome!
+
+To get you started, there are some first steps you'll need to do and some posts to for you to read and review.
+
+## First steps
+
+1. **Send your GitHub username and Discord username to the Team Leader**
+    - We use Discord as our communication platform and this way so you can be added to the Seedcase Project server asap. If you don't have a Discord account, you can go to [discord.com](https://discord.com) and create one.
+    - You will need to be added to the SDCA and Seedcase organizaions (and potentially other repositories) on GitHub. If you don't have a GitHub account, you can go to [github.com](https://github.com) and create one.
+2. **Set up GitHub two-factor authentication (2FA)**
+    - See [this post](github.md) (you will need 2FA to access the Seedcase repositories)
+3. **Order IT equipment**
+    - Talk to the Team Leader about which IT equipment you will need (e.g., computer, mouse, keyboard, and dock station) and Team Leader will help you with ordering it.
+
+## Posts to read and review
+
+In the Seedcase project, we practice a "documentation first" culture. This means that when you read through posts, we encourage you to create issues and pull requests, when you stumble upon something that's unclear or information that's missing or outdated.
+
+Therefore, before you start to read and review the pages in the list below, we encourage you to read the following posts
+with introductions and guidelines to our workflows:
+
+1. [Documentation First Culture](https://seedcase-project.org/community/guide-entries/documentation-first/)
+2. [Workflows for adding content](workflow.md)
+3. If you will need to add new posts: [Adding posts](https://seedcase-project.org/community/guide-entries/adding-posts/) (this post contains guidelines on that)
+
+Now that you have read the above, you can review the pages below:
+
+1. [Onboarding SDCA website](https://steno-aarhus.github.io/research/onboarding.html)
+    - This website is for general onboarding at SDCA and covers general onboarding, such as the general code of conduct and details on varous social activities and events
+    - Any subpages of particular interest? Maybe "Welcome and getting started (as a PhD student?)", "General practicalities" and "IT basics"?  
+2. [Our Seedcase Team Docs website](https://team.seedcase-project.org/) (which is where this post is located)
+    - This website covers the documentation, contributing guidelines, onboarding material, and event details/agendas for the Seedcase Project team
+3. [General contributing guidelines website](https://seedcase-project.org/community/contributing)
+    - This website covers the contributing guidelines of the Seedcase project
+    - Potentially start with the "Decisions" section, describing *why* we choose to use the tools that we use: [Why Discord?](https://seedcase-project.org/community/decisions/why-discord/) and [Why Quarto?](https://seedcase-project.org/community/decisions/why-quarto/)
+    - Then go to the [individual guide entries](https://seedcase-project.org/community/contributing) covering guidelines for contributing
+4. [Design documentation](https://seedcase-project.org/design/)
+    - The design documentation covers stakeholders, design decisions, software architecture, data architecture, and more.
+
+If something is unclear to you, you are more than welcome to reach out to the other team members on Discord. We'll love to help you out.
+
+## Software
+
+When you have received your IT equipment, there are some software you'll need to install. Go to the [Software we use](software.md) post.

entries/software.md

@@ -2,20 +2,50 @@
 title: "Software we use"
 ---
 
+## Software
+
 These are the software we use as a team:
 
--   IDE:
-    -   [RStudio](https://posit.co/download/rstudio-desktop/)
-    -   [VS Code](https://code.visualstudio.com/download)
-    -   [PyCharm](https://www.jetbrains.com/pycharm/download/) (not the
-        Professional version)
--   [Git](https://git-scm.com/downloads)
--   [Justfile](https://just.systems/man/en/chapter_4.html)
--   [Docker](https://docs.docker.com/get-docker/)
--   [Python 3](https://www.python.org/downloads/)
--   [Discord](https://discord.com/download)
+- IDEs:
+    - [RStudio](https://posit.co/download/rstudio-desktop/)
+        - What do we use RStudio for in the Seedcase project?
+    - [VS Code](https://code.visualstudio.com/download)
+        - A lightweight but powerful source code editor that comes with built-in support for multiple languages and has a rich ecosystem of extensions (such as C++, C#, Java, Python, PHP, Go, .NET).
+    - [PyCharm](https://www.jetbrains.com/pycharm/download/) (the Community Edition, not the
+          Professional version)
+        - An integrated development environment used for programming in Python.
+- [Discord](https://discord.com/download)
+    - Our main communication software. If you are interested in why we chose Discord, see the [Why Discord](https://seedcase-project.org/community/decisions/why-discord/) decision post.
+- [Docker](https://docs.docker.com/get-docker/)
+    - The containerization software we use. If you are interested in why we use Docker, see the
+    [why Docker](https://seedcase-project.org/design/decisions/why-docker/index.html) decision post.
+- [Git](https://git-scm.com/downloads)
+    - We use Git for version control and our code is located at GitHub. As to you we chose GitHub, see the Why GitHub decision post (not created as of October 2023)
+- [Justfile](https://just.systems/man/en/chapter_4.html)
+    - Just is a command runner that we use to create and re-generate diagrams that were created with PlantUML. For more information, see the [Creating PlantUML images](create-puml-images.md) post.
+- [PanDoc](https://pandoc.org/installing.html)
+    - PanDoc is a  ree-software document converter, widely used as a writing tool and as a basis for publishing workflows. 
+- [Python 3](https://www.python.org/downloads/)
+    - Python is main development language we use. Check out the [Why Python](https://seedcase-project.org/design/decisions/why-python/index.html) post, if you are interested in why this decision was made.
+- [Quarto](https://quarto.org/docs/get-started/)
+    - We use Quarto to build the website and write general documentation. If you are interested in why we chose Quarto, see the [Why Quarto](https://seedcase-project.org/community/decisions/why-quarto/index.html) decision post.
 
 These are the recommended helper or workflow type software:
 
--   [GitHub CLI](https://cli.github.com/manual/installation)
+- [GitHub CLI](https://cli.github.com/manual/)
+    - GitHub CLI (command line interface) is a command-line tool that brings pull requests, issues, GitHub Actions, and other features specific to GitHub to the terminal.
+- [Homebrew](https://docs.brew.sh/Installation)
+    - If you work on a Macbook, Homebrew can ease the installation process of some of the software listed above by enabling you to install software directly in the Terminal by using the `brew install [package_name]` command. E.g., git can be installed by writing `brew install git` in the terminal. Easy!
+
+## Recommended VS Code Extensions
+
+If you use VS Code, but are not familiar with extensions, they are add-ons or plugins
+that enhance the functionality of VS Code. They can be installed to customise and extend the
+capabilities of VS Code to support a wide range of programming languages, frameworks, and
+development tasks.
 
+In the [extensions.json](https://github.com/seedcase-project/seedcase-project/blob/main/.vscode/extensions.json)
+in the seedcase-project repository, you will find the extensions we recommend for working
+in that repository with VS Code. When you clone the seedcase-project repository and open your local repository
+folder in VS Code, a pop-up message will recommend the extensions in this file.
+We recommend that you install these to help you set up smoother workflows.

entries/update-meetings.md

@@ -25,3 +25,5 @@ update meetings:
 
 Save any detailed or technical discussion on or about code for the [code
 review meetings](code-review-meetings.md).
+
+Tip: These meetings are held on Discord. To enter, simply go to the seedcase project server on Discord, find "Voice channels", in the menu on the left, and click on "General".