diff --git a/docs/migration-report.md b/docs/migration-report.md index ab59882..4134c67 100644 --- a/docs/migration-report.md +++ b/docs/migration-report.md @@ -1,6 +1,6 @@ # DokuWiki migration report -This report accounts for the 29 selected DokuWiki source pages and their 28 unique Starlight destinations. `pages/start.txt` and `pages/study.txt` were intentionally combined on the landing page. Generic DokuWiki documentation was outside the selected source scope. Newer live-wiki captures remain research material under `to-be-studied/` and are not published. Present-day association references use the current Department of Advanced Computing Sciences name; legacy department and programme names remain only in clearly historical material. +This report accounts for the 29 selected DokuWiki source pages and their 28 unique Starlight destinations. `pages/start.txt` and `pages/study.txt` were intentionally combined on the landing page. Generic DokuWiki documentation was outside the selected source scope. Most newer live-wiki captures remain research material under `to-be-studied/`; three reviewed practical guides are published as supplemental content, and newer laptop recommendations were merged into the existing laptop destination. Present-day association references use the current Department of Advanced Computing Sciences name; legacy department and programme names remain only in clearly historical material. ## Source inventory @@ -32,11 +32,11 @@ This report accounts for the 29 selected DokuWiki source pages and their 28 uniq | `pages/study/master_dsdm.txt` | `src/content/docs/master-dsdm/index.md` | page | Yes | **Converted source link:** Maastricht University education website. **Removed source links:** redundant DokuWiki year-navigation links, now covered by site navigation. | None | Standardized DSDM and master’s-programme capitalization; disclosed that promised summaries and old exams were absent from the export | | `pages/study/master_dsdm/year_1.txt` | `src/content/docs/master-dsdm/year-1/index.md` | page | Yes | **None.** The source and destination contain no content links. | None | Corrected punctuation and retained the source-era structure | | `pages/study/master_dsdm/year_2.txt` | `src/content/docs/master-dsdm/year-2/index.md` | page | Yes | **None.** The source and destination contain no content links. | None | Corrected punctuation and retained the source-era structure | -| `pages/study/useful_information.txt` | `src/content/docs/useful-information/index.md` | page | Yes | **Converted source link:** Maastricht University education website. **Newly verified links:** the four migrated child pages, derived from the exported child-page inventory. | None | Corrected heading capitalization and introductory grammar; scoped contribution guidance to repository maintainers | +| `pages/study/useful_information.txt` | `src/content/docs/useful-information/index.md` | page | No | **Converted source link:** Maastricht University education website. **Newly verified links:** the four migrated child pages plus the three reviewed practical guides. | None | Reframed the landing page around practical guides and legacy reference pages; scoped contribution guidance to repository maintainers | | `pages/study/useful_information/pages/dke_locations.txt` | `src/content/docs/useful-information/dke-locations.md` | page | Yes | **Converted source links:** the three Google Maps URLs. No links were repaired or removed. | None | Corrected sentence fragments, comma use, and room-list phrasing | | `pages/study/useful_information/pages/handy_locations.txt` | `src/content/docs/useful-information/handy-locations.md` | page | Yes | **None.** The source and destination contain no content links. | None | Corrected capitalization; marked the two empty sections as awaiting content | | `pages/study/useful_information/pages/it_services.txt` | `src/content/docs/useful-information/it-services.md` | page | Yes, prominently historical | **Converted source links:** ICT manuals, Inner City map, Student Portal, Student Desktop Anywhere, and MyPrint. **Removed hyperlinking:** legacy EleUM and VPN URLs were retained as non-clickable historical code. No successor URL was added. | None | Corrected errors such as “Eletctronic” and “contact he,” plus punctuation and service-name casing | -| `pages/study/useful_information/pages/laptop_buy_advice.txt` | `src/content/docs/useful-information/laptop-buying-advice.md` | page | Yes, prominently historical | **None.** The source and destination contain no content links. | None | Corrected spacing in capacities, punctuation, and awkward phrasing while retaining old price/specification facts | +| `pages/study/useful_information/pages/laptop_buy_advice.txt` | `src/content/docs/useful-information/laptop-buying-advice.md` | page | No | **None.** The source and destination contain no content links. | None | Incorporated the newer 16 GB RAM, 512 GB SSD, mid-range processor, M-series Mac, and Nvidia/CUDA guidance; replaced obsolete price tiers with budget-neutral advice | ## Removed unresolved home-page targets @@ -68,10 +68,10 @@ The Study Abroad source makes time-sensitive claims tied to 2022, including elig The IT page names source-era services, URLs, and instructions, including MyUM, EleUM, Student Desktop Anywhere, VPN steps, printing, and historical timetable navigation. These are not presented as current instructions. The destination uses a prominent historical warning, converts useful source links, and retains the legacy EleUM and VPN URLs only as non-clickable historical code. No successor URL was added. -## Historical laptop advice +## Laptop buying advice -Laptop prices, processor generations, RAM and storage capacities, operating-system assumptions, and the listed performance tiers reflect the source period. They were preserved rather than silently replaced with current purchasing advice. The page prominently labels the entire section historical and tells readers to verify current programme requirements, prices, and hardware support. +The newer live-wiki source added a practical baseline of 16 GB RAM, a 512 GB SSD, a mid-range processor, M-series Mac compatibility guidance, and an Nvidia GPU recommendation for CUDA workloads. Those recommendations are now incorporated into the existing Laptop Buying Advice destination. Obsolete price tiers and low-capacity configurations were generalized instead of being presented as current purchasing targets. ## Publication boundary -Raw research captures remain stored only under `to-be-studied/` and are not served by the site. The 93-page newer-wiki snapshot is retained for research, while the 115-page legacy crawl was reviewed to recover missing course information. That review produced 54 supplemental course pages in `src/content/docs/`; empty placeholders, excluded utility pages, and raw captures remain unpublished. +Raw research captures remain stored only under `to-be-studied/` and are not served by the site. The 93-page newer-wiki snapshot is retained for research, while reviewed derivatives of its Housing Guide, Linux Tricks, and Surviving DACS pages are registered and published as supplemental content. Its newer Laptop Buying Advice recommendations were merged into the destination already covered by the original migration manifest. The 115-page legacy crawl produced 54 supplemental course pages in `src/content/docs/`; empty placeholders, excluded utility pages, and all remaining raw captures remain unpublished. diff --git a/src/content/docs/useful-information/surviving-dacs.md b/src/content/docs/useful-information/surviving-dacs.md index 9bc08ab..9f7c38a 100644 --- a/src/content/docs/useful-information/surviving-dacs.md +++ b/src/content/docs/useful-information/surviving-dacs.md @@ -83,7 +83,7 @@ Reuse and second-hand markets can reduce both cost and waste. Walking, cycling, ### Housing -Begin searching early, use several channels, and verify the advertiser, property, total cost, and contract before transferring money. See the [Housing Guide](./housing-guide/) for a fuller checklist. +Begin searching early, use several channels, and verify the advertiser, property, total cost, and contract before transferring money. See the [Housing Guide](../housing-guide/) for a fuller checklist. ### Food diff --git a/tests/useful-guides.test.mjs b/tests/useful-guides.test.mjs index c0069f8..67d6775 100644 --- a/tests/useful-guides.test.mjs +++ b/tests/useful-guides.test.mjs @@ -73,3 +73,9 @@ test('Useful Information navigation exposes every practical guide', async () => assert.match(sidebar, new RegExp(`slug: 'useful-information/${slug}'`)); } }); + +test('Surviving DACS links to its sibling Housing Guide route', async () => { + const content = await readFile(`${docsRoot}/surviving-dacs.md`, 'utf8'); + assert.match(content, /\]\(\.\.\/housing-guide\/\)/); + assert.doesNotMatch(content, /\]\(\.\/housing-guide\/\)/); +}); diff --git a/to-be-studied/README.md b/to-be-studied/README.md index 1f953b8..6a95fcf 100644 --- a/to-be-studied/README.md +++ b/to-be-studied/README.md @@ -8,10 +8,12 @@ The snapshot was captured on 2026-08-02 with `npm run capture:live-wiki`. The cr Files under `live-wiki/2026-08-02/` retain their public source URL and capture date. `manifest.json` records the sorted capture inventory and SHA-256 hash of every Markdown file. `comparison.md` compares that inventory with the 29-entry DokuWiki export manifest. +On 2026-08-11, Housing Guide, Linux Tricks, and Surviving DACS were editorially reviewed and published through separately registered Markdown destinations under `src/content/docs/useful-information/`. Newer recommendations from Laptop Buying Advice were merged into its existing migration destination. The raw captures remain research files and are not served directly. + ## Legacy PDF recovery The 332 PDFs recovered from the Vimmex DokuWiki media namespaces on 2026-08-03 have moved to `../public/media/legacy-dokuwiki/` for publication. Their original namespace hierarchy is preserved. `../docs/pdf-inventory.tsv` records their source URLs, public paths, byte sizes, and SHA-256 checksums; `../docs/pdf-archive.md` documents the recovery and validation results. On 2026-08-03, the repository maintainer confirmed that permission had been obtained from the document creators and that the files may be exposed on the wiki. `../docs/pdf-publication-review.md` records this publication basis and supersedes the earlier hold. -Nothing in this directory is published by Starlight. This directory must never be moved or copied into `src/content/docs/` without a separate content review. It must also remain outside `public/`. +Nothing in this directory is served directly by Starlight. Raw research must never be moved or copied into `src/content/docs/` without a separate content review and an explicit source registration. This directory must remain outside `public/`.