Smeagol

Smeagol is an open source wiki that assists with documentation in the Cloudogu EcoSystem. Careful documentation of code and configurations helps to distribute and manage knowledge within organizations. The challenge here is finding an easy way to keep the documentation up-to-date and making the documentation process a simple one for developers.

Features of Smeagol

Setting up the wiki

The wiki software manages the documentation directly on the code in the Git repository. A new entry is set up by creating a relevant smeagol.yaml file in the repository. Then, the wiki pages can be stored in the repository as text files.

Editing content via IDE

Since the content of the wiki is stored as text files in the repository, each developer can update the documentation while they are working on the code. All changes are pushed directly to the repository.

Editing via browser

With Smeagol, the content of the wiki can be viewed in a browser and edited with the included WYSIWYG editor. This way, even team members who are not working on the repository itself can still view and edit the content. When using the editor, changes are automatically committed to the repository.

Integration in CES

Smeagol is directly integrated into the Cloudogu EcoSystem toolchain. The repository browser displays all of the repositories that the user is authorized to view in the SCM-Manager.

Our blog has some tips for using Smeagol: Smeagol, the Git wiki

Cloudogu EcoSystem Download

Download Cloudogu EcoSystem

Would you like to set up the CES independently? No problem, we provide you with a free download for the Community Edition.

Download CES