Skip to content
Yamuno
Browse

Known Issues & Limitations

Page trees don't update themselves

Issue: A page tree is built once, into the editor. Pages added, moved or renamed later don't appear. Workaround: Open the editor and insert the page tree again.

Page trees include up to 100 pages

Issue: Larger sections are cut off at 100 pages, and pages with more than 8 children show a "+ N more pages" box instead of the rest. Workaround: Start from a page lower down, or choose a smaller depth.

Links in hand-edited mind maps

Issue: Mermaid can't link mind map nodes, so page tree mind maps keep their links as %% click comment lines. A box you add by hand has no link. Workaround: Add a line such as %% click myNode href "/wiki/pages/viewpage.action?pageId=123" for it, or use a flowchart, where right-click linking works.

Right-click linking is for flowcharts

Issue: Link to a page… appears only on flowchart boxes. Workaround: Use a flowchart for diagrams whose boxes should open pages.

Very large diagrams

Issue: A diagram can hold up to 200,000 characters of code. Diagrams over about 20 KB are loaded from storage when the page opens, so they appear a moment later. Workaround: Split very large diagrams into several smaller ones.

Diagrams from GitHub, GitLab or Bitbucket don't update by themselves

Issue: The page shows the diagram as it was saved. A change to the file isn't shown until an editor refreshes it. Workaround: Open the editor, choose Refresh from … in the file's menu, then save.

Diagrams imported from a URL aren't linked

Issue: Unlike repository imports, a URL import has no Refresh or Commit. Workaround: Import the file again, or connect the repository in Settings → Repositories and import from there.

One connection per service

Issue: Each Confluence site has one GitHub App, one GitLab token and one Bitbucket token. A GitLab token reaches one group, project or person's projects; a Bitbucket token one workspace or repository. Workaround: Use a GitLab token from a parent group, or a Bitbucket workspace token, to cover more repositories.

Bitbucket Data Center isn't supported

Issue: Bitbucket connects to Bitbucket Cloud only. Workaround: Use Import from a URL for public files, or copy the diagram into the editor.

Stuck on something this page does not cover? Ask the developers.