We're working hard on an upcoming release of Swimm that will bring us quite a few steps closer to saving documentation without the need for additional metadata within the document itself. We want Swimm to be a full-fledged docs-as-code (DAC) solution, so we're working on getting rid of the JSON.
Swimm Markdown (pronounced "swahm-dee", or "swimm-dee") is how the new format is being developed, and we'll be telling you all about it in the very near future.
Right now, our product teams really need your help. They need you to upgrade to the new type now, so that they can continue developing it.
This only takes a minute, and we thank you from the deep oceans of our 💙s.
Fix and commit any outdated docs.
At the top of the repository view, you'll see the following banner:
Click that, and follow through the dialog box that asks you to open a PR to upgrade:
After that, merge the PR to your main branch. Your upgrade is now done.
Make sure you're running the latest version.
In a terminal, change into the repo directory and run the following command to verify that all your docs are up-to-date:
Fix and commit any outdated docs using the Swimm app.
.swm/swimm.json file (relative to your repository root). The file
for the repository that hosts this website currently looks like this:
You need to add the custom
configuration object as shown below:
Then, in a terminal, run the following command:
swimm upgrade-files -a
You'll see something resembling the following output:
┌─[timothypost@tim] - [~/code/swimm.io/docs.swimm.io] - [2021-10-13 10:22:18]
└─ <git:(master 6fe4730) > swimm upgrade-files -a
Info: Verifying units before attempting to upgrade...
✔ How Do Links Work? (ANv7K) is verified.
✔ Creating Static Pages (CVk1i) is verified.
✔ Creating Custom Components (DV_q9) is verified.
✔ Building The Site Manually (Rmly2) is verified.
✔ Building Via The Makefile (W8D2A) is verified.
✔ Creating Documents (W9vNb) is verified.
✔ Creating Blog Posts (axB2v) is verified.
✔ SEO Plugin Configuration (faNzX) is verified.
✔ Starting Upgrade... ⭐✨⭐
✔ * ANv7K
✔ * CVk1i
✔ * DV_q9
✔ * Rmly2doc
✔ * W8D2A
✔ * W9vNb
✔ * axB2v
✔ * faNzX
✔ Upgrade finished successfully! ⭐✨⭐
┌─[timothypost@tim] - [~/code/swimm.io/docs.swimm.io] - [2021-10-13 10:23:26]
└─ <git:(master 6fe4730✗➦✱+) >
You can then commit and push the changes. Your upgrade is now done.