Merge branch 'feature/tech-interviews' into 'main'

Delete migrated howto

See merge request devpro-labs/enablement/tech-notes!8

Author: Bertrand Thomas

.markdownlint.yml

@@ -3,6 +3,6 @@ default: true
 # MD007:
 #   indent: 4   # needed by PyMdown Extensions
 MD013:
-  line_length: 320
+  line_length: 350
 MD033: false
 MD046: false

CONTRIBUTING.md

@@ -27,6 +27,28 @@ npm run build
 npm run serve
 ```
 
+## Customization
+
+> [!IMPORTANT]
+> Make sure to review this customizations when doing upgrades
+
+### Table of contents width
+
+Idea found on [discussion #8799](https://github.com/facebook/docusaurus/discussions/8799):
+
+```bash
+npm run swizzle @docusaurus/theme-classic -- DocItem/Layout
+```
+
+Files are in `src/theme/DocItem/Layout`.
+
+> [!TIP]
+> Run the command to see what is possible to swizzle:
+>
+> ```bash
+> npm run swizzle @docusaurus/theme-classic -- --list
+> ```
+
 ## Lint before committing
 
 Reproduce locally GitLab jobs:

LICENSE

@@ -12,6 +12,5 @@ Feel free to [contribute](CONTRIBUTING.md)!
 * [Fundamentals](docs/fundamentals/fundamentals.md)
 * [Guides](docs/guides/guides.md)
 * [Organizations](docs/organizations/organizations.md)
-* [Studies](docs/studies/adr/adr.md)
 
 <!-- https://wiki-tech.io/ -->

README.md

@@ -1,59 +1,164 @@
-# Linux commands
+# Linux terminal
 
-## Usual commands
+## Additional packages
+
+Name     | Details
+---------|---------------------------------------------------------------------------------------------------------------------------------
+**wget** | GNU Wget is a free software package for retrieving files using HTTP, HTTPS, FTP and FTPS the most widely-used Internet protocols
+
+<!-- TODO: difference between cat/less/more -->
+
+## Shortcuts
+
+Shortcut   | Action
+-----------|--------------------------------
+`Ctrl`+`R` | Search a command in the history
+
+## Commands
+
+### Machine and OS
+
+Display system information (e.g., kernel version, OS type):
 
 ```bash
-# switches between keyboard layouts
-loadkeys fr
-# looks at drive disk space
-df -h
-# interacts with services (like firewalld)
-systemctl <stop|disable|start|status> <service_name>
-# review sudo config
-cat /etc/sudoers
-# manages services, boot processes, and system states
-systemd
-# displays logging system events
-journald
-# interacts with the dynamic firewall management tool (when installed)
-firewalld
-# configures and displays network interfaces
-ip
-# displays system information (e.g., kernel version, OS type)
 uname
-# displays memory usage
-free
-# views memory information
-less /proc/meminfo
-# views CPU information
-more /proc/cpuinfo
-# displays kernel and distribution version information
+```
+
+View memory information:
+
+```bash
+cat /proc/meminfo
+```
+
+View CPU information:
+
+```bash
+cat /proc/cpuinfo
+```
+
+Display kernel and distribution version information
+
+```bash
 cat /proc/version
-# displays kernel name and release
+```
+
+Display kernel name and release:
+
+```bash
 uname -or
-# displays the network node hostname
+```
+
+### System check
+
+Monitor live system processes:
+
+```bash
+top
+```
+
+Look at drive disk space:
+
+```bash
+df -h
+```
+
+Display memory usage:
+
+```bash
+free
+```
+
+### Network
+
+Configure and displays network interfaces:
+
+```bash
+ip
+```
+
+Display the network node hostname:
+
+```bash
 hostname
 uname -n
-# displays user and group information for the current or specified user
+```
+
+Interact with the dynamic firewall management tool (when installed):
+
+```bash
+firewalld
+```
+
+### Services
+
+Interact with services (like firewalld):
+
+```bash
+systemctl <stop|disable|start|status> <service_name>
+```
+
+Manage services, boot processes, and system states:
+
+```bash
+systemd
+```
+
+Display logging system events:
+
+```bash
+journald
+```
+
+### User managament
+
+Review sudo config:
+
+```bash
+cat /etc/sudoers
+```
+
+Display user and group information for the current or specified user:
+
+```bash
 id
-# updates a user’s password
-passwd
-# adds a new user (account is locked until a password is set)
+```
+
+Add a new user (account is locked until a password is set):
+
+```bash
 useradd xxx
-# extends or validates the sudo credentials timestamp (typically for 5 minutes)
+```
+
+Updates a user's password:
+
+```bash
+passwd
+```
+
+### User settings
+
+Extend or validate the sudo credentials timestamp (typically for 5 minutes):
+
+```bash
 sudo -v
-# monitors live system processes
-top
 ```
 
-## Common packages
+Switch between keyboard layouts:
 
-Name     | Details
----------|---------------------------------------------------------------------------------------------------------------------------------
-**wget** | GNU Wget is a free software package for retrieving files using HTTP, HTTPS, FTP and FTPS the most widely-used Internet protocols
+```bash
+loadkeys fr
+```
 
-## Shell shortcuts
+### Processes
 
-Shortcut     | Action
--------------|--------------------------------
-`Ctrl` + `R` | Search a command in the history
+Look for specific processes:
+
+```bash
+ps -ef | grep <process_name>
+```
+
+Kill a process and its children:
+
+```bash
+kill -TERM -- -<process_id>
+```

docs/fundamentals/infrastructure/operating-systems/linux-commands.md

@@ -4,12 +4,18 @@
 
 Name          | Families | Package manager
 --------------|----------|----------------
+Arch          | Arch     | pacman
+AlmaLinux     | Red Hat  | dnf
+Alpine Linux  | Alpine   | apk
+CentOS Stream | Red Hat  | dnf/yum
 Debian        | Debian   | apt
-Ubuntu        | Debian   | apt
 Fedora        | Red Hat  | dnf
-CentOS Stream | Red Hat  | dnf/yum
-AlmaLinux     | Red Hat  | dnf
-Rocky Linux   | Red Hat  | dnf
-Arch          | Arch     | pacman
 openSUSE      | SUSE     | zypper
-Alpine Linux  | Alpine   | apk
+Ubuntu        | Debian   | apt
+Rocky Linux   | Red Hat  | dnf
+
+## Components
+
+* [Commands](linux-commands.md)
+* [Filesystem](linux-filesystem.md)
+* [Kernel](linux-kernel.md)

docs/fundamentals/infrastructure/operating-systems/linux.md

@@ -1,3 +1,5 @@
-# Continuous Integration (CI)
+# CI
+
+Continuous Integration (CI)
 
 [martinfowler.com/articles/continuousIntegration](https://martinfowler.com/articles/continuousIntegration.html)

docs/fundamentals/practices/ci.md

@@ -0,0 +1,12 @@
+# DDD
+
+Domain Driven Design
+
+## Learn
+
+* Starting point with [Tackle Business Complexity in a Microservice with DDD and CQRS Patterns](https://docs.microsoft.com/en-us/dotnet/architecture/microservices/microservice-ddd-cqrs-patterns/)
+
+### Code examples
+
+* [citerus/dddsample-core](https://github.com/citerus/dddsample-core)
+* [kgrzybek/modular-monolith-with-ddd](https://github.com/kgrzybek/modular-monolith-with-ddd)

docs/fundamentals/practices/ddd.md

@@ -1,4 +1,6 @@
-# Infrastructure-as-Code (IaC)
+# IaC
+
+Infrastructure-as-Code (IaC)
 
 ## Definitions
 

docs/fundamentals/practices/iac.md

@@ -1,15 +1,22 @@
 # Practices
 
-## IT
+## Build
+
+* [Continuous Integration (CI)](ci.md)
+* [Domain Driven Design (DDD)](ddd.md)
+* [Static site generators (SSG)](ssg.md)
+* [Testing](testing.md)
+* [Test Driven Development](tdd.md)
+
+## Run
 
-* [Continuous Integration](ci.md)
-* [DevOps](devops.md)
 * [GitOps](gitops.md)
-* [Infrastructure-as-Code](iac.md)
 * [Post mortem](post-mortem.md)
 * [Site Reliability Engineering](sre.md)
+* [Infrastructure-as-Code (IaC)](iac.md)
 
 ## Project management
 
 * [Agile](agile.md)
+* [DevOps](devops.md)
 * [SCRUM](scrum.md)