Which version of mermaid is supported in Azure DevOps Wikis - azure-devops

Which version of mermaid is currently supported in AzureDevOps. In the official docs it only mentions some diagrams that are supported.
I was really loosing a lot of time because I was using features that are not supported by Azure DevOps.
I now went down to feature from 8.2.6 but I would like to know for sure which version is supported.
Thank you

Based on your description, I further checked this problem. Currently, the wiki supports the following Mermaid diagram types:
Sequence diagrams
Gantt Charts
Wiki does not support other types of Mermaid diagrams, so this seems to have nothing to do with the version. Regarding this feature, I help you find a user voice. You can vote and add comments on it.

As of Sprint 200 (March 2022) the following diagrams are supported up to version 8.13.9:
Flowchart
Sequence diagrams
Gantt charts
Pie charts
Requirement diagrams
State diagrams
User Journey

I looked at the files downloaded from the Developer Tools: Network tab. I first thought it was 6.3 based upon the url but looking into the json I saw this...
"./package.json":function(e){e.exports={name:"mermaid",version:"8.2.3",description:"Markdownish syntax for generating flowcharts, sequence diagrams, class diagrams, gantt charts and git graphs.",main:"dist/mermaid.core.js",keywords:["diagram","markdown","flowchart","sequence diagram","gantt","class diagram","git graph"]
So as of this moment... I believe it to be 8.2.3

Checking the listed support page it shows the following diagrams as supported:
Supported:
Sequence diagrams
Gantt charts
Flowcharts
Unsupported:
Pie charts
Requirement diagrams
State diagrams
User Journey
Testing each of the diagram types in a DevOps wiki page using the examples from the mermaid website, the first three work. The rest return an error "Unsupported diagram type". Truly amazing they have it documented as supported but in reality its not.

Sad that azure devops (server) wiki still not support mermaid.
One hack could be using the 'markdown' button on https://mermaid.live/
and then paste the markdown from mermaid.live into devops wiki.

Related

Accessible Tagged PDF with BIRT

We are using BIRT to create PDF-files from our website, but now we need to change the PDFs to meet the accessibility demands. I have tried to search for an answer how to make accessible tagged PDF with BIRT, but haven't found any answer. Even this https://www.eclipse.org/birt/ documentation doesn't talk about accessibility nor making tagged PDF.
So is it possible to add tags with BIRT or do we need to change BIRT to some completely different tool? If we need to change the tool, I would much appreciate info about tool which we could use. We have quite many PDF templates created with BIRT and all need to be changed to meet the accessibility demands.
With the Open Source version of BIRT, creating tagged PDFs is not possible AFAIK.
However, in a BIRT IDE built from source, it looks as if development in this direction started (IIRC there were "PDF Tag" properties in the advanced properties).
Maybe the commercial BIRT version from OpenText can generate tagged PDFs - I don't know and I would really appreciate more info about this topic from the BIRT project.
Edit: According to http://otadocs.opentext.com/documentation/ihub3/help/adg/adg24/index.html#page/ADG/DesigningReport.1.03.html#, this should be possible with the commercial version.

Correct Use of UML Icons for Source Control in Continuous Delivery Modelling

Working on a proposal diagram of a Continuous Delivery Model, and am looking for a way to represent Source/Version Control in the diagram. I don't see a specific icon for Source/Version Control in yED graph editor, and google searches don't seem to be helping much. I can't use the same icon as database since I also have a number of databbase objects in the same model as well.
Is there a generally accepted or official diagram shape/icon/whatever for source control (git, svn)?
No, there is no icon for version control defined in UML.
(Nor is there one for a database for that matter.)
You can download the full specification of UML on the OMG website.

Using Enterprise Architect API for documentation in Gitbook

we use Sparx Enterprise Architect for creating our UML diagrams. Also we write our architecture documentation based on Gitbook. Currently we copy & paste the diagrams into MS Paint and save them as PNG to use it the image in the Gitbook.
Our build system then creates a HTML version of the Gitbook and publishes the documentation to our webserver.
The question is that we want to reference the diagrams directly from Gitbook/Markdown to Enterprise Architect. Is there any kind of REST API for Enterprise Architect available to directly link to a PNG/image?
Yes, there is, but you'll need to install the cloud server component.
As an alternative you could also:
Export the model as HTML and reference the element/diagram on there. You can use the GUID to get stable hyperlinks
Use the regular automation API to build your own export/synchronize mechanism.

What's the name for this type of flowchart?

Take a look at this; it's very obvious how it works and what its purpose is:
(source: json.org)
What's this type of chart called?
Can I make this kind of chart in Visio?
What software do you recommend for making this kind of chart?
It's called a railroad diagram. It can more specifically be called a syntax diagram. Not sure about Visio support but other tools can get the job done: What is a good tool for creating railroad diagrams?
(source: antlr.org)
If you have a grammar file you can try to get it working in ANTLR Works, which is specifically built for working with the syntax and grammar of languages.
These are called Syntax diagrams (or railroad diagrams).
They can be created with Visio or Creative Docs .NET
See here for more info:
Tool for generating railroad diagram used on json.org
It is a syntax diagram; not sure if there is any visio addon to paint this kind of chart.

JIRA Plugins: What do you use? [closed]

As it currently stands, this question is not a good fit for our Q&A format. We expect answers to be supported by facts, references, or expertise, but this question will likely solicit debate, arguments, polling, or extended discussion. If you feel that this question can be improved and possibly reopened, visit the help center for guidance.
Closed 10 years ago.
JIRA is a very extensible bug/task tracking tool. As such, newcomers feel lost as to what plugins they should install.
Please share your thoughts what plugins (both free and paid) that you consider a "must-add" for JIRA!
Here are the plugins I couldn't live without:
Timesheet report - Summarizes any user's time spent over a weekly period: http://confluence.atlassian.com/display/JIRAEXT/Timesheet+report+and+portlet
Charting plugin - Generate charts from any issue navigator: http://confluence.atlassian.com/display/JIRAEXT/JIRA+Charting+Plugin
Subversion plugin - Link and view subversion commit history to a JIRA issue: http://confluence.atlassian.com/display/JIRAEXT/JIRA+Subversion+plugin
Labels plugin - Lets you tag any JIRA issue and search on tags: http://confluence.atlassian.com/display/JIRAEXT/JIRA+Labels+Plugin
We use JIRA Labels plug-in, which allows to add a "tags" field: http://confluence.atlassian.com/display/JIRAEXT/JIRA+Labels+Plugin
Plugins that stand out the most (paid and free) are mentioned on Atlassian's plugin page:
https://plugins.atlassian.com/search/by/jira
And the company I work for develops JIRA Client, a desktop client for JIRA (paid unless you're open-source): http://almworks.com/jiraclient
We use Tempo Plugin extensively for time tracking, project management, planning and billing.
We are also big fans of Greenhopper for project management (Scrum/KanBan).
We use quite a few extra JIRA plugins; the charts for visualizing find/fix ratios etc., Release status plugin for a nice visualization of how each release stands, the SVN integration, Linker and Activity Stream plugins for integration with Confluence, and the Firefox search portlet that lets you use JIRA as a search engine option in Firefox.
Some of our developers also like the Eclipse plugin for JIRA that lets them manage their list of issues direct from the IDE.
The only paid plugin we tried out was Greenhopper, since we are an agile shop, but we didn't find it useful enough to be worth buying.
We really liked the following:
Create and Link: Allows us to create an issue, then create another issue that automatically gets linked to the original
JIRA Suite Utilities: Incredibly useful plug-in! The most helpful feature was it's ability to make field's required after a transition.
JIRA Misc Workflow Extensions: multiple useful conditions and validators for work flows.
To integrate Jira with Saleforce or SugarCRM you should consider Go2group CRM plugin
We use ScreenMail for JIRA as it lets us create screencasts to our issues. It removes the need to write long descriptions of specifications or bugs. Screencasts makes it possible for me to record my screen and talk whats on my mind to my mic. Anyone who has access to the issues can watch the video later.
This has given me more freedom to work whenever as I do not need to call a meeting always when something more complicated has come up. Work with overseas partners has also been easier as I am able to work in my own timezone most of the time.
Whats important here is that you do not need to install any additional software or rent harddrive space. The plugin does everything for you. Just install the plugin and start recording.
I found the JIRA Workflow Visualization Plugin very useful when first setting up Jira workflows - it gives a pictorial representation of your workflows, which makes it easier to view than the list of steps that Jira gives you by default.
For customizing the way Jira works and adding new features:
Behaviours Plugin
Jira Scripting Suite
With this to you could practically do almost anything. I used it to write Issues 24hrs notifications, sending email from templates that are saved in Confluence, automatic issue moving, closing, cloning and sub-issue creating, and much more...
To complete the last two plugins, some plugins that add special features to make life easier:
JIRA Toolkit Plugin
JIRA Workflow Toolbox
A nice plugin to display external pages:
Jira Custom Content Plugin
For more advanced JIRA reports, charts and dashboards there is eazyBI application with standard JIRA integration as well as installable eazyBI reports and charts plugin for JIRA.