content: expose useful guides in navigation

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' },
     ],
   },
 ];

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/)

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);

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}'`));
+  }
+});