BB-DOC-1 (#842)

Update tutorials. Still a draft, but added lot of content. Need to finish Kubernetes page (upload images), parallel computing and datacenters.
bluebanquise · Oct 18, 2023 · dc06b1c · dc06b1c
1 parent ead8c85
commit dc06b1c
Show file tree

Hide file tree

Showing 53 changed files with 19,255 additions and 682 deletions.
diff --git a/documentation/README.md b/documentation/README.md
@@ -1,3 +1,7 @@
+WARNING !!!
+
+THIS DOCUMENTATION IS DEPRECATED AND IS UNDER REWORK.
+
 # BlueBanquise documentation
 
 Shields: [![CC BY-NC-SA 4.0][cc-by-nc-sa-shield]][cc-by-nc-sa]

diff --git a/tutorials/docs/datacenters_elec_hydro_parallel.md b/tutorials/docs/datacenters_elec_hydro_parallel.md
@@ -0,0 +1,26 @@
+# The electricity and hydraulic parallel
+
+Datacenter are plants with many fields of technicity. One cannot master all aspects of the equipment. There is however a trick to at least understand or “feel” physical events of hydraulic and electricity when mastering one of them: the similarity.
+
+Water moving through pipes is a flux of particles (water molecule).
+Electricity moving through cables is a flux of particles (electrons).
+
+In both cases, similarities can be used, and allows you to understand most aspects of datacenters.
+
+## Flux and power
+
+Pressure is like tension. Flow rate is like intensity.
+
+Power from hydraulic is related to pressure, power from electricity is related to tension.
+
+Heat generated by flow rate in pipes (friction) is related to flow rate and pipe resistance. Heat generated by electricity is related to intensity and cable resistance.
+
+The flow rate is related to pipe resistance and pressure applied. The flow intensity is related to cable resistance and tension applied.
+
+When a pipe divide and reach multiple points (without taking into account pipe friction and gravity), all these points share the same pressure. When a cable divide and reach multiple points (without taking into account cable resistance and electric fields), all these points share the same tension.
+
+## Tank and Capacitor
+
+A tank full of water and opened at the bottom will empty at an exponential decreasing speed (the less water in the tank, the less pressure to push water outside, and the less flow rate).
+
+A capacitor full of energy linked to a circuit will discharge at an exponential decreasing speed (the less energy, the less tension to push electrons to move).
diff --git a/tutorials/docs/datacenters_introduction.md b/tutorials/docs/datacenters_introduction.md
@@ -0,0 +1,6 @@
+# Datacenters Introduction
+
+**! WORK IN PROGRESS SECTION !**
+
+This tutorial is the result of my own experience.
+I may have written errors or outdated data, if you think so, please open me an issue on github.
diff --git a/tutorials/docs/datacenters_safety.md b/tutorials/docs/datacenters_safety.md
diff --git a/tutorials/docs/extra.css b/tutorials/docs/extra.css
@@ -0,0 +1,30 @@
+/* Style for the tile container */
+.comment-tile {
+    display: flex;
+    border: 1px solid #ccc;
+    max-width: 100%; /* Adjust the width as needed */
+    margin: 20px 0px;
+    background: #e6e6e6;
+}
+
+/* Style for the image container on the left */
+.comment-tile-image {
+    flex: 0 0 96px; /* Fixed width for the image container */
+    display: flex;
+    align-items: stretch; /* Stretch the image container vertically */
+}
+
+/* Style for the image itself */
+.comment-tile-image img {
+    width: 100%;
+    height: auto;
+    flex: 1;
+}
+
+/* Style for the text container on the right */
+.comment-tile-text {
+    flex: 1; /* Allow it to grow and take remaining space */
+    padding: 2px 10px;
+    color: #222222de;
+    font-size: .6rem;
+}
diff --git a/tutorials/docs/hpc.md b/tutorials/docs/hpc.md