Incognito-Wiki/docs/migration-report.md

77 lines
15 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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. 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
“Outdated” records whether the destination displays the standard warning that its migrated information may be outdated. Link handling distinguishes converted source links, converted plain-text references, newly verified links, genuine removals, and sources with no content links. “None” means that the source had no item in that category, not that it was skipped during review.
| Source | Destination | Mode | Outdated | Link handling | Missing assets | Significant spelling or grammar fixes |
| --- | --- | --- | --- | --- | --- | --- |
| `pages/start.txt` | `src/content/docs/index.mdx` | page | Yes, on migrated programme notes | **Converted source links:** Bachelor, Master AI, Master DSDM, Useful Information, the Incognito site, and ICT manuals. **Newly verified link:** the current DACS page replaced the source-era DKE department URL. **Genuinely removed links:** unresolved Minutes, Event Manuals, and Function Manuals targets; redundant study/year navigation was omitted. | None | Recast the welcome copy and normalized programme terminology |
| `pages/study.txt` | `src/content/docs/index.mdx` | merge | Yes | **Converted source links:** Bachelor, Master AI, Master DSDM, and the YouTube embed. **Genuinely removed links:** redundant year navigation was omitted. | None | Condensed the source-era university and programme overview, including omission of its dated growth/ranking sentence; corrected punctuation, capitalization, and bachelor/master wording |
| `pages/study/msv_incognito.txt` | `src/content/docs/about-incognito.md` | page | No | **Converted source link:** the MSV Incognito website. No links were repaired or removed. | None | Combined the source website link with the association-description sentence from `pages/start.txt`; the present-day introduction uses the current DACS name |
| `pages/study/bachelor.txt` | `src/content/docs/data-science-and-ai/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 | Corrected bachelor capitalization and sentence structure; disclosed that promised summaries and old exams were absent from the export |
| `pages/study/bachelor/year_1.txt` | `src/content/docs/data-science-and-ai/year-1/index.md` | page | Yes | **Newly verified links:** the two migrated project pages, derived from the exported child-page inventory. No source content links required repair or removal. | None | Standardized Year 1/block capitalization |
| `pages/study/bachelor/year_1/project_1-1.txt` | `src/content/docs/data-science-and-ai/year-1/project-1-1.md` | page | Yes | **None.** The source and destination contain no content links. | None | Corrected punctuation and clarified prerequisite prose without changing requirements |
| `pages/study/bachelor/year_1/project_1-2.txt` | `src/content/docs/data-science-and-ai/year-1/project-1-2.md` | page | Yes | **None.** The source and destination contain no content links. | None | Corrected grammar, spacing, and capitalization |
| `pages/study/bachelor/year_2.txt` | `src/content/docs/data-science-and-ai/year-2/index.md` | page | Yes | **Newly verified links:** the two migrated project pages and honours placeholder. **Genuinely removed link:** the malformed DokuWiki media-manager/upload URL. | None | Standardized Year 2/block capitalization |
| `pages/study/bachelor/year_2/honours_programme.txt` | `src/content/docs/data-science-and-ai/year-2/honours-programme.md` | page | Yes | **None.** The source and destination contain no content links. | None | Replaced the source's “Under Construction” text with the standard awaiting-content placeholder |
| `pages/study/bachelor/year_2/project_2-1.txt` | `src/content/docs/data-science-and-ai/year-2/project-2-1.md` | page | Yes | **Converted plain-text reference:** Project 1-1 became a verified local link. The Project 3-1 reference remains text. No source link was repaired. | None | Corrected grammar and standardized project naming |
| `pages/study/bachelor/year_2/project_2-2.txt` | `src/content/docs/data-science-and-ai/year-2/project-2-2.md` | page | Yes | **Converted plain-text reference:** Project 1-2 became a verified local link. No source link was repaired. | None | Corrected punctuation and standardized project naming |
| `pages/study/bachelor/year_3.txt` | `src/content/docs/data-science-and-ai/year-3/index.md` | page | Yes | **Newly verified links:** the four migrated child pages, derived from the exported child-page inventory. No source content links required repair or removal. | None | Corrected block references and the schedule explanation |
| `pages/study/bachelor/year_3/bachelors_thesis.txt` | `src/content/docs/data-science-and-ai/year-3/bachelors-thesis.md` | page | Yes | **None.** The source and destination contain no content links. | None | Corrected possessive bachelors wording, punctuation, and sentence flow |
| `pages/study/bachelor/year_3/honours_programme.txt` | `src/content/docs/data-science-and-ai/year-3/honours-programme.md` | page | Yes | **None.** The source and destination contain no content links. | None | Preserved the source title and made its under-construction state an explicit awaiting-content placeholder |
| `pages/study/bachelor/year_3/project_3-1.txt` | `src/content/docs/data-science-and-ai/year-3/project-3-1.md` | page | Yes | **Converted plain-text reference:** Project 2-1 became a verified local link. No source link was repaired. | None | Corrected grammar while retaining the stated prerequisites and reading |
| `pages/study/bachelor/year_3/study_abroad.txt` | `src/content/docs/data-science-and-ai/year-3/study-abroad.md` | page | Yes, with a 2022-specific warning | **Newly verified link:** the official UM study-abroad page. No source links existed. | None | Corrected grammar; did not silently modernize the dated eligibility claims |
| `pages/study/master_ai.txt` | `src/content/docs/master-ai/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 masters-programme capitalization and punctuation; disclosed that promised summaries and old exams were absent from the export |
| `pages/study/master_ai/year_1.txt` | `src/content/docs/master-ai/year-1/index.md` | page | Yes | **Newly verified links:** the two migrated research-project pages, derived from the exported child-page inventory. No source content links required repair or removal. | None | Corrected sentence structure and project naming |
| `pages/study/master_ai/year_1/project_mai_1.txt` | `src/content/docs/master-ai/year-1/research-project-1.md` | page | Yes | **None.** The source and destination contain no content links. | None | Corrected punctuation and rendered the project name consistently |
| `pages/study/master_ai/year_1/project_mai_2.txt` | `src/content/docs/master-ai/year-1/research-project-2.md` | page | Yes | **None.** The source and destination contain no content links. | None | Corrected punctuation and rendered the project name consistently |
| `pages/study/master_ai/year_2.txt` | `src/content/docs/master-ai/year-2/index.md` | page | Yes | **None.** The source and destination contain no content links. | None | Corrected capitalization and hyphenation and framed the two schedule statements historically |
| `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 masters-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 | 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 | 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
The old home page exposed Minutes and Manuals targets, but the selected export contained no corresponding source pages and therefore no valid destinations. These knowingly broken targets were removed. Source programme links became local navigation, the Incognito and ICT links were converted, and the source-era DKE department URL was replaced with the newly verified current DACS page.
## Source-era summaries and exams claim
The Bachelor, Master AI, and Master DSDM overview sources said course summaries and old exams could be found in corresponding folders. The selected export did not contain those materials. A later recovery from the live legacy server found 332 current PDFs across the DokuWiki media namespaces. After the user confirmed permission from the documents' creators, the recovered files were published under `public/media/legacy-dokuwiki/` and catalogued on the Previous Exams and Documents page.
## Recovered legacy PDF archive
The public archive contains 332 PDFs totaling 417,839,494 bytes. All files retain their original DokuWiki namespace hierarchy. Every file has a valid PDF signature and was successfully parsed with Poppler `pdfinfo`. The tab-separated `docs/pdf-inventory.tsv` records the original media ID, public URL, repository path, source URL, byte size, and SHA-256 checksum. There are 297 unique content hashes; 68 paths belong to 33 duplicate-content groups. Duplicate paths were retained because their original course and namespace context matters for discoverability.
The files were recovered on 2026-08-03 through the legacy DokuWiki Media Manager and `_media` endpoints at `https://msvincognito.nl/wiki/`. The origin certificate had expired, so retrieval used the explicitly supplied hostname-to-IP mapping with TLS certificate verification disabled for that origin only. Deleted historical media revisions were not added; the archive represents files available from the current media namespaces. The publication decision is documented in `docs/pdf-publication-review.md`; publication proceeded after the user confirmed permission from the documents' creators.
## Removed DokuWiki controls
Editing, page-creation, upload, cache, and index-menu controls belonged to DokuWiki rather than to the public content. `NEWPAGE`, `indexmenu`, `~~NOCACHE~~`, edit links, registration/upload instructions, and namespace-only navigation were removed. Maintainers now edit Markdown or MDX through the repository workflow.
## Removed Year 2 media-upload link
The Bachelor Year 2 source contained a malformed media-manager/upload link. That editing control could not resolve on the static site, so it was removed without exposing an obsolete or private editing URL.
## Historical Study Abroad guidance
The Study Abroad source makes time-sensitive claims tied to 2022, including eligibility and application guidance. Those claims remain for historical context, but the destination explicitly says they must be verified against current Maastricht University and programme rules. The official UM study-abroad page is a newly verified destination link; it did not originate in the source.
## Historical IT services
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.
## Laptop buying advice
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 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.