Menu

Moving a GitHub wiki to Confluence Cloud (and when not to move it)
📰

Moving a GitHub wiki to Confluence Cloud (and when not to move it)

DEV Community: github·Mesut Sözüer·19 days ago
#c7Z1QZQX
#devtogithub#technology#devto#dev#wiki
Reading 0:00
15s threshold

Your engineers write in the GitHub wiki. Everyone else lives in Confluence. Sooner or later someone asks for "the wiki, but in Confluence", and you find out there is no importer for that.

There are two honest answers, and which one is right depends on a single question: where will people edit after the move?

If the wiki is being retired and Confluence becomes the only place to edit, copy it once .

If developers will keep editing on GitHub, don't copy it . Show the wiki pages inside Confluence instead, so there is still only one version.

Here is how to do each.

Path A: copy the wiki once

1. Get every page as a file

A GitHub wiki is a Git repository of its own. Clone it next to the main repo:

git clone https://github.com/OWNER/REPO.wiki.git cd REPO.wiki ls * .md # one file per page; Home.md is the start page

Enter fullscreen mode

Exit fullscreen mode

File names use hyphens where page titles have spaces, so Getting-Started.md is the page "Getting Started".…

Continue reading — create a free account

Join HashtagPLUS to read full articles, follow hashtags, vote, and join the conversation.