From a9554ec75610d75279950e00db7b5e7d7719dd62 Mon Sep 17 00:00:00 2001
From: msa46 <mohamad.sanaye462@gmail.com>
Date: Tue, 11 Aug 2026 18:54:52 +0200
Subject: [PATCH] content: expose useful guides in navigation

---
 src/config/sidebar.mjs                       |  5 ++++-
 src/content/docs/useful-information/index.md | 20 +++++++++++---------
 tests/content-audit.test.mjs                 |  5 ++++-
 tests/useful-guides.test.mjs                 | 10 ++++++++++
 4 files changed, 29 insertions(+), 11 deletions(-)

diff --git a/src/config/sidebar.mjs b/src/config/sidebar.mjs
index d6b8abd..dd5c7cd 100644
--- a/src/config/sidebar.mjs
+++ b/src/config/sidebar.mjs
@@ -80,10 +80,13 @@ export const sidebar = [
     label: 'Useful Information',
     items: [
       { slug: 'useful-information' },
+      { slug: 'useful-information/housing-guide' },
+      { slug: 'useful-information/laptop-buying-advice' },
+      { slug: 'useful-information/linux-tricks' },
+      { slug: 'useful-information/surviving-dacs' },
       { slug: 'useful-information/dke-locations' },
       { slug: 'useful-information/handy-locations' },
       { slug: 'useful-information/it-services' },
-      { slug: 'useful-information/laptop-buying-advice' },
     ],
   },
 ];
diff --git a/src/content/docs/useful-information/index.md b/src/content/docs/useful-information/index.md
index e32853e..ac56cb1 100644
--- a/src/content/docs/useful-information/index.md
+++ b/src/content/docs/useful-information/index.md
@@ -1,21 +1,23 @@
 ---
 title: Useful Information
-description: Historical student information for the Department of Data Science and Knowledge Engineering at Maastricht University.
+description: Practical guides and student information for Maastricht University DACS students.
 ---
 
-:::caution[Historical information]
-This information originated in the previous wiki and may be outdated.
-:::
+This section brings together practical guides created by students alongside reference information from the previous Incognito wiki.
 
-The following pages contain useful information for students of the Department of Data Science and Knowledge Engineering at Maastricht University, including information about IT services and where to find the Rules and Regulations.
-
-For the most up-to-date overview of our studies, visit the [Maastricht University education website](https://www.maastrichtuniversity.nl/education).
+For the official and most up-to-date overview of programmes and university services, visit the [Maastricht University education website](https://www.maastrichtuniversity.nl/education).
 
 Repository maintainers can add useful information to the most relevant Markdown page and update the manual sidebar. They should add a new page only when no existing page fits.
 
-## Useful pages
+## Practical guides
+
+- [Housing Guide](./housing-guide/)
+- [Laptop Buying Advice](./laptop-buying-advice/)
+- [Linux Tricks](./linux-tricks/)
+- [Surviving DACS](./surviving-dacs/)
+
+## Other useful information
 
 - [Locations of DKE](./dke-locations/)
 - [Handy Locations](./handy-locations/)
 - [IT Services](./it-services/)
-- [Laptop Buying Advice](./laptop-buying-advice/)
diff --git a/tests/content-audit.test.mjs b/tests/content-audit.test.mjs
index b9a134c..e1dffef 100644
--- a/tests/content-audit.test.mjs
+++ b/tests/content-audit.test.mjs
@@ -349,7 +349,10 @@ for (const file of [
   test(`${file} contains clean migrated Markdown`, async () => {
     const content = await readFile(file, 'utf8');
     assert.match(content, /^---\n[\s\S]*title:/);
-    if (file !== 'src/content/docs/useful-information/laptop-buying-advice.md') {
+    if (![
+      'src/content/docs/useful-information/index.md',
+      'src/content/docs/useful-information/laptop-buying-advice.md',
+    ].includes(file)) {
       assert.match(content, /This information originated in the previous wiki and may be outdated\./);
     }
     for (const pattern of forbidden) assert.doesNotMatch(content, pattern);
diff --git a/tests/useful-guides.test.mjs b/tests/useful-guides.test.mjs
index 12cccac..c0069f8 100644
--- a/tests/useful-guides.test.mjs
+++ b/tests/useful-guides.test.mjs
@@ -63,3 +63,13 @@ test('published guides omit unsafe or legally questionable source recommendation
   assert.doesNotMatch(linux, /password=["']?<password>/i);
   assert.doesNotMatch(survival, /Sci-Hub|Library Genesis|Library\.nu/i);
 });
+
+test('Useful Information navigation exposes every practical guide', async () => {
+  const landing = await readFile(`${docsRoot}/index.md`, 'utf8');
+  const sidebar = await readFile('src/config/sidebar.mjs', 'utf8');
+  assert.doesNotMatch(landing, /:::caution\[Historical information\]/);
+  for (const slug of ['housing-guide', 'laptop-buying-advice', 'linux-tricks', 'surviving-dacs']) {
+    assert.match(landing, new RegExp(`\\]\\(\\./${slug}/\\)`));
+    assert.match(sidebar, new RegExp(`slug: 'useful-information/${slug}'`));
+  }
+});