Merge branch 'feature/techno-folders' into 'main'

Improve sort in sidebar and create sub folder for company important technologies

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

Author: Bertrand Thomas

README.md

@@ -1,23 +1,17 @@
-# DevPro Tech Notes
+# DevPro Technical Notes
 
-<!-- [![GitHub Action CI status](https://github.com/devpro/information-technology-guide/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/devpro/information-technology-guide/actions/workflows/ci.yml) -->
 [![GitLab Pipeline Status](https://gitlab.com/devpro-labs/enablement/tech-notes/badges/main/pipeline.svg)](https://gitlab.com/devpro-labs/enablement/tech-notes/-/pipelines)
-<!-- [![GitLab Pipeline Status](https://img.shields.io/gitlab/pipeline/devpro-labs/docs/information-technology-guide/main?label=Pipeline&logo=gitlab)](https://gitlab.com/devpro-labs/docs/information-technology-guide/-/pipelines) -->
+[![GitHub Action CI status](https://github.com/devpro/tech-notes/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/devpro/tech-notes/actions/workflows/ci.yml)
+[![GitHub Action Deploy status](https://github.com/devpro/tech-notes/actions/workflows/deploy.yml/badge.svg?branch=main)](https://github.com/devpro/tech-notes/actions/workflows/deploy.yml)
 
-Technical notes about Information Technology (IT).
+Source for [tech.devpro.fr](https://tech.devpro.fr).
+Feel free to [contribute](CONTRIBUTING.md)!
 
 ## Sections
 
-* [Architecture Decision Records](docs/adr/adr.md)
-* [Communities](docs/communities/communities.md)
-* [Companies](docs/companies/companies.md)
-* [Foundations](docs/foundations/foundations.md)
-* [Infrastructure](docs/infrastructure/infrastructure.md)
-* [Institutions](docs/institutions/institutions.md)
-* [Practices](docs/practices/practices.md)
-* [Scripts](docs/scripts/scripts.md)
-* [Independent projects](docs/independent-projects/independent-projects.md)
-* [Standards](docs/standards/standards.md)
-* [Workstations](docs/workstations/workstations.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/ -->

docs/fundamentals/infrastructure/compute-platforms/compute-platforms.md

@@ -1 +1,7 @@
 # Compute platforms
+
+Compute platforms are hardware architectures designed for various computing tasks, from embedded systems to high-performance applications.
+
+## Platform types
+
+* [Single-board computers (SBC)](sbc.md)

docs/fundamentals/infrastructure/compute-platforms/sbc.md

@@ -1,4 +1,11 @@
-# Single-board computers (SBC)
+# Single-board computers
 
-- Odroid
-- Raspberry PI
+Single-board computers (SBCs) are compact compute platforms integrating CPU, memory, and I/O on a single circuit board, ideal for prototyping, education, and IoT applications.
+They offer a versatile, low-power solution within the broader category of compute platforms.
+
+## Brands
+
+Brand            | Organization                                                                               | Focus
+-----------------|--------------------------------------------------------------------------------------------|------
+**Odroid**       | [HardKernel](../../../organizations/companies/hardkernel/hardkernel.md)                    | Emphasizes high-performance ARM-based models for demanding tasks such as media playback and emulation
+**Raspberry PI** | [Raspberry PI foundation](../../../organizations/foundations/raspberry-pi/raspberry-pi.md) | Prioritizes accessibility, a vast community, and ease of use for education and prototyping

docs/fundamentals/infrastructure/networking/glossary.md

@@ -14,29 +14,29 @@ OSI  | Open Systems Interconnection
 
 ## Protocols
 
-Name     | Meaning
----------|-------------------------------------------
-802.1Q   | -
-BGP      | Border Gateway Protocol
-DHCP     | Dynamic Host Configuration Protocol
-EIGRP    | Enhanced Interior Gateway Routing Protocol
-Ethernet | -
-FTP      | -
-HSRP     | -
-HTTP     | -
-ICMP     | -
-IMAP     | -
-IP       | Internet Protocol
-IPv6     | -
-NTP      | -
-OSPF     | -
-POP3     | -
-PPP      | -
-RIP      | -
-RSTP     | -
-SFTP     | -
-SMTP     | -
-SNMP     | Simple Network Management Protocol
-TCP      | Transport Control Protocol
-TFTP     | -
-UDP      | User Datagram Protocol
+Name     | Meaning                                    | Used In
+---------|--------------------------------------------|------------------------
+802.1Q   | VLAN Tagging Standard                      | VLAN configuration
+BGP      | Border Gateway Protocol                    | Internet routing
+DHCP     | Dynamic Host Configuration Protocol        | IP address assignment
+EIGRP    | Enhanced Interior Gateway Routing Protocol | Enterprise routing
+Ethernet | Local Area Networking Technology           | LAN connectivity
+FTP      | File Transfer Protocol                     | File transfers
+HSRP     | Hot Standby Router Protocol                | Router redundancy
+HTTP     | Hypertext Transfer Protocol                | Web browsing
+ICMP     | Internet Control Message Protocol          | Network diagnostics
+IMAP     | Internet Message Access Protocol           | Email access
+IP       | Internet Protocol                          | Network communication
+IPv6     | Internet Protocol Version 6                | Next-gen networking
+NTP      | Network Time Protocol                      | Time synchronization
+OSPF     | Open Shortest Path First                   | Intranet routing
+POP3     | Post Office Protocol Version 3             | Email retrieval
+PPP      | Point-to-Point Protocol                    | Direct connections
+RIP      | Routing Information Protocol               | Small network routing
+RSTP     | Rapid Spanning Tree Protocol               | Network loop prevention
+SFTP     | Secure File Transfer Protocol              | Secure file transfers
+SMTP     | Simple Mail Transfer Protocol              | Email sending
+SNMP     | Simple Network Management Protocol         | Network monitoring
+TCP      | Transport Control Protocol                 | Reliable data transfer
+TFTP     | Trivial File Transfer Protocol             | Simple file transfers
+UDP      | User Datagram Protocol                     | Low-latency data transfer

docs/fundamentals/standards/database.md renamed to docs/fundamentals/standards/databases.md

@@ -1,6 +1,56 @@
 # Databases
 
-## Properties
+## Families
+
+### Relational Databases (RDBMS)
+
+These use structured tables with fixed schemas, rows, and columns, queried via SQL.
+They excel in applications requiring complex joins and strong consistency.
+
+* MySQL / MariaDB
+* PostgreSQL
+* Oracle
+* Microsoft SQL Server
+
+### NoSQL Databases
+
+These provide schema-less or flexible data models for handling large volumes of unstructured or semi-structured data, often distributed across clusters.
+
+They are subdivided into several types / subcategories.
+
+#### Document Model (Document-Oriented)
+
+Stores data as semi-structured documents (e.g., JSON, BSON), ideal for hierarchical data in content management or real-time apps.
+
+* MongoDB
+* CouchDB
+* RavenDB
+
+#### Key-Value Stores
+
+Simple databases mapping keys to values, optimized for high-speed lookups like caching or session storage.
+
+* Redis
+* Amazon DynamoDB
+* Riak
+
+#### Wide-Column Stores (Column-Family)
+
+Organize data in flexible columns within rows, optimized for read/write on massive datasets, suited for large-scale analytics.
+
+* Apache Cassandra
+* HBase
+* ScyllaDB
+
+#### Graph Databases
+
+Model data as nodes and edges for relationship-heavy use cases like social networks or fraud detection.
+
+* Neo4j
+* ArangoDB
+* JanusGraph
+
+## Design principles
 
 ### ACID
 

docs/guides/courses/courses.md

@@ -2,5 +2,5 @@
 
 ## Content
 
-* [git](git/git.md)
-* [MongoDB](mongodb/mongodb.md)
+* [git](git/intro.md)
+* [MongoDB](mongodb/intro.md)

docs/guides/courses/git/_category_.yml

@@ -0,0 +1 @@
+label: Git

docs/guides/courses/git/git.md

@@ -0,0 +1,9 @@
+---
+sidebar_position: 1
+---
+
+# Introduction
+
+This course will guide you through the basic git actions.
+
+At anytime, feel free to look at the [official documentation](https://git-scm.com/docs) for more information about a specific command.

docs/guides/courses/git/intro.md

@@ -2,38 +2,57 @@
 
 In this step, we are going to look at the environment and see how to view & update the configuration.
 
-* Display the git client version:
+Display the git client version:
 
-`git version`
+```bash
+git version
+```
 
-* Look at the available git commands:
+Look at the available git commands:
 
-`git help`
+```bash
+git help
+```
 
-* List all configuration:
+List all configuration:
 
-`git config -l`
+```bash
+git config -l
+```
 
-* Set your identity (you can update it):
+Set your identity (you can update it)
 
-`git config --global user.name "John Doe"`
+```bash
+git config --global user.name "John Doe"
+git config --global user.email [email protected]
+```
 
-`git config --global user.email [email protected]`
+Set default branch name:
 
-* Set default branch name:
+```bash
+git config --global init.defaultBranch main
+```
 
-`git config --global init.defaultBranch main`
+List at the updated configuration:
 
-* List at the updated configuration:
+```bash
+git config -l
+```
 
-`git config -l`
+You can also look at one configuration in particular:
 
-* You can also look at one configuration in particular:
+```bash
+git config user.name
+```
 
-`git config user.name`
+Finally look at where it is stored
 
-* Finally look at where it is stored
+```bash
+more $HOME/.gitconfig
+```
 
-`more $HOME/.gitconfig`
+References:
 
-References: [Installing Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git), [First-Time Git Setup](https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup), [Getting Help](https://git-scm.com/book/en/v2/Getting-Started-Getting-Help)
+- [Installing Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
+- [First-Time Git Setup](https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup)
+- [Getting Help](https://git-scm.com/book/en/v2/Getting-Started-Getting-Help)