Ons GitHub- en JIRA-integrasies is hier!!

Met GitHub kan u docs-as-code in Markdown-lêers skryf. Dit sinkroniseer outomaties na 'n Archbee-versameling waar dit intern met nie-tegniese spanlede gedeel kan word. Boonop trek u voordeel uit dieselfde publieke deelmeganisme as elke ander versameling.

Dit is doelbewus 'n eenrigting-sinkronisering (van GitHub na Archbee). Ons glo git as 'n stelsel werk uitstekend omdat daar 'n vereiste vir menslike interaksie is — wanneer merge conflicts ontstaan, sal iemand die inhoud in die lêers handmatig moet saamsmelt. Wanneer een kant van die stelsel geoutomatiseer is (soos dit in ons geval sou wees as die integrasie tweerigting was), sou 'n tweerigtingstelsel nie u inhoud teen beskadiging tydens die proses kon beskerm nie.

U kan dan die versameling maklik na u domein publiseer en dit na wens kombineer met WYSIWYG-versamelings om u dokumentasiewebwerwe te bou.

Nota: Ons GitHub/git-integrasies is nog maar aan die begin. Ons beplan om nog 'n redigeerderblok te skep wat na stukke kode in die repositories verwys sodat u SDKs kan dokumenteer en dit met die kode gesinkroniseer kan hou. Soortgelyk aan ons Doc Verifications-funksie sal die nuwe blok u waarsku wanneer die kode nie meer met die dokumentasie in Archbee gesinkroniseer is nie. Dit sal ook 'n uitstekende funksie wees vir die interne aanboording van ontwikkelaars, aangesien dit u in staat stel om reekse te skep om hulle deur u kodebasis te neem indien nodig. Dit is een van ons belangrikste funksies wat volgende kwartaal bekendgestel sal word.

Nou kan u JIRA-kwessies plak nadat u die integrasie bygevoeg het, en hulle sal outomaties in Archbee-dokumente ingebed word (en die inhoud gesinkroniseer gehou word).

Ons JIRA-integrasie werk nou goed, en ons wil die vermoëns daarvan uitbrei op grond van u terugvoer.

Gelukkige dokumentering van die Archbee-span af!