<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by jeeva.c on Medium]]></title>
        <description><![CDATA[Stories by jeeva.c on Medium]]></description>
        <link>https://medium.com/@jeeva.co3?source=rss-a2ff916095b6------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/0*wcKazxfv-kgTewiR</url>
            <title>Stories by jeeva.c on Medium</title>
            <link>https://medium.com/@jeeva.co3?source=rss-a2ff916095b6------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sat, 21 Nov 2026 11:56:27 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@jeeva.co3/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Create UML diagrams using PlantUML and Integrate with Readme]]></title>
            <link>https://medium.com/@jeeva.co3/create-uml-diagrams-using-plantuml-and-integrate-with-readme-628343345573?source=rss-a2ff916095b6------2</link>
            <guid isPermaLink="false">https://medium.com/p/628343345573</guid>
            <category><![CDATA[plantuml]]></category>
            <category><![CDATA[readme]]></category>
            <category><![CDATA[uml-diagrams]]></category>
            <dc:creator><![CDATA[jeeva.c]]></dc:creator>
            <pubDate>Mon, 13 Jun 2022 16:06:29 GMT</pubDate>
            <atom:updated>2022-06-13T16:06:29.349Z</atom:updated>
            <content:encoded><![CDATA[<h3><strong>What is UML diagram?</strong></h3><p>A UML diagram is a diagram based on the UML (Unified Modeling Language) with the purpose of visually representing a system along with its main actors, roles, actions, artifacts or classes, in order to better understand, alter, maintain, or document information about the system.</p><h3><strong>What is PlantUML?</strong></h3><p><strong>PlantUML</strong> is an open-source tool allowing users to create diagrams from a plain text language. Besides various UML diagrams, PlantUML has support for various other software development related formats (such as Block diagram, Gantt chart, Mind map and etc…), as well as visualisation of JSON and YAML files.</p><h3><strong>What is .MD file?</strong></h3><p>MD files are <strong>the extensions of files created Markdown language software</strong>. Markdown is a lightweight markup language intended for one purpose, to be used to format text on the web with plain text formatting syntax.</p><h3><strong>Create UML diagrams using PlantUML</strong></h3><p>With help of PlantUML components we can create the following different kind of diagrams</p><ul><li>Sequence diagram</li><li>Usecase diagram</li><li>Class diagram</li><li>Object diagram</li><li>Activity diagram</li><li>Component diagram</li><li>Deployment diagram</li><li>State diagram</li><li>Timing diagram</li></ul><p>We can simply create a new file with the extension of .pu/.puml. If we using Visual studio code we can use PlantUML extension which provides helpful features like preview our UML diagrams, export diagrams to PDF/image, format our UML code etc…</p><p><strong>Sample Sequence PlantUML diagram:</strong></p><pre>@startuml ClientServerCommunication</pre><pre>Client -&gt; Server: Authentication Request</pre><pre>Server --&gt; Client: Authentication Response</pre><pre>Client -&gt; Server: Another authentication Request</pre><pre>Server &lt;-- Client: Another authentication Response</pre><pre>@enduml</pre><blockquote><strong>ClientServerCommunication </strong>is name of the diagram. When we create some SVG/image it will be created in the name of <strong>ClientServerCommunication.</strong></blockquote><p><strong>Preview:</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/702/1*kIAG0wNX8ldGdtwo5WXE6A.png" /></figure><p>For example, we can use this kind of diagrams to maintain complex work flow of our system/Architecture of the platform etc... so this will help team to understand the system/platform well that they working on.</p><p>Since this can be done using UML, If there is any change in the system work flow or Architecture, it will be very easy to edit the existing diagram and keep updated as the system/platform.</p><blockquote>To know more about PlantUML components visit <a href="https://plantuml.com/">https://plantuml.com/</a></blockquote><p><strong>Generate SVG from PlantUML file</strong></p><p>To generate SVG from PlantUML file, need to have plantuml.jar. We can download this from <a href="https://plantuml.com/download">https://plantuml.com/download</a>.</p><pre>java -jar plantuml.jar -v -tsvg &lt;file_name&gt;.pu</pre><p>The above command will generate the equivalent SVG of the UML diagram. Which will be later integrated with README file.</p><p><strong>Integrate UML diagram with Readme file and Automate the SVG creation</strong></p><p>Create a new directory and initialise it with a GitHub repo.</p><p>The folder structure something like below</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/636/1*EsxE5aywioo5fQ4tBRLQzA.png" /></figure><p>Create a GitHub workflow file (generate.yml) with the following code.</p><pre>name: Generate svg from uml</pre><pre>on:</pre><pre>push:</pre><pre>branches:</pre><pre>- main</pre><pre>jobs:</pre><pre>build:</pre><pre>runs-on: ubuntu-latest</pre><pre>steps:</pre><pre>- uses: actions/checkout@v3</pre><pre>- name: Generate Diagrams</pre><pre>run: java -jar plantuml.jar -v -tsvg &quot;**.pu&quot;</pre><pre>- name: Commit Diagrams</pre><pre>run: |</pre><pre>git config --local user.email &quot;action@github.com&quot;</pre><pre>git config --local user.name &quot;GitHub Action&quot;</pre><pre>git add .</pre><pre>git commit -m &quot;Update generated diagrams&quot; || exit 0</pre><pre>- name: Push Diagrams</pre><pre>uses: ad-m/github-push-action@master</pre><pre>with:</pre><pre>github_token: ${{ github.token }}</pre><p>README.MD file something like the below</p><pre><strong># UML Diagrams</strong></pre><pre><strong>### Client Server Communication</strong></pre><pre>![](./ClientServerCommunication.svg)</pre><p>README.MD preview</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/844/1*6ybsmEV1bPfOKfz1KEel8g.png" /></figure><p>So, Whenever we push the changes to GitHub, the Github workflow itself generate the updated UML diagrams from the plantUML file and updated it in the Github repo. In this way you will always see the latest UML diagram in our Readme file.</p><p>Thanks for Reading!</p><p><strong>Reference:</strong></p><ul><li><a href="https://plantuml.com/">https://plantuml.com/</a></li><li><a href="https://gist.github.com/thedmeyer/8b50362ae71ecbadabb17f8683c70ece">https://gist.github.com/thedmeyer/8b50362ae71ecbadabb17f8683c70ece</a></li><li><a href="https://marketplace.visualstudio.com/items?itemName=jebbs.plantuml">https://marketplace.visualstudio.com/items?itemName=jebbs.plantuml</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=628343345573" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>