<?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 Raviraj Subramanian on Medium]]></title>
        <description><![CDATA[Stories by Raviraj Subramanian on Medium]]></description>
        <link>https://medium.com/@ravirajsubramanian?source=rss-a92c7ae1810------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/2*9buJaQEr5dlcRBpvXfSzbQ.jpeg</url>
            <title>Stories by Raviraj Subramanian on Medium</title>
            <link>https://medium.com/@ravirajsubramanian?source=rss-a92c7ae1810------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Fri, 20 Nov 2026 07:54:20 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@ravirajsubramanian/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[Simple interest is compound interest]]></title>
            <link>https://medium.com/@ravirajsubramanian/simple-interest-is-compound-interest-4a3ee66b1138?source=rss-a92c7ae1810------2</link>
            <guid isPermaLink="false">https://medium.com/p/4a3ee66b1138</guid>
            <category><![CDATA[financial-planning]]></category>
            <category><![CDATA[compound-interest]]></category>
            <category><![CDATA[personal-finance]]></category>
            <dc:creator><![CDATA[Raviraj Subramanian]]></dc:creator>
            <pubDate>Sun, 30 Jun 2024 07:21:18 GMT</pubDate>
            <atom:updated>2024-06-30T07:21:18.195Z</atom:updated>
            <content:encoded><![CDATA[<p>If you save 100 rupees one-time and receives 10% interest rate every year accumulated. Can you tell me how many years would it take to cross 200 rupees? If you think, 10 years, you’re wrong.</p><p>Compound interest accelerates both profits and losses faster over time.</p><blockquote>Compound interest is the eighth wonder of the world. He who understands it, earns it. He who doesn’t, pays it. — Albert Einstein</blockquote><p>We cannot imagine compound interest because our brain can only process linear momentum and not an exponential momentum.</p><p><em>So, let me simplify this for you.</em></p><p>Everything around us is measured in simple interest only. We can also process the same easily. Compound interest is just simple interest accumulated. Either ways in gains and losses.</p><p>For example, if you have saved up money in a bank deposit that reinvests the interests, it will grow slowly in the initial years. It will result in growing faster in the later years because of the bigger corpus getting accumulates year over year.</p><p>If you have debt, the same pattern can be seen. You would have to pay interest for the amount that you have outstanding in the loan. If the loan amount get accumulated with its interest, then compound interest start working in the reverse. You would pay even more interest for the outstanding principal amount with interest accumulated.</p><p>Financially, paying off a loan is equivalent to saving and investing the same money with the same interest rate. In fact, the investment returns attract taxes, paying off certain loans can be tax deducted. So, it’s even more beneficial to pay off the loans.</p><p>Paying off debt gives peace. But, at the cost of growth from the investments. So, don’t worry calculating and finding which is beneficial. Just pay off debt or invest depending on your taste. Compound interest works either ways. But, peace and thrills are not. Whether to pay off debt or save and invest is rather a psychological decision than a financial one.</p><p>If you’re still wondering the answer for the initial question. It only takes 8 years to double the saved amount with 10% interest rate accumulated.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*r_WxqtvYo6eOSc4Zo7NhSw.png" /><figcaption>Depicting compound interest as a solution for the the initial question</figcaption></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4a3ee66b1138" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[My first task as a Developer Advocate]]></title>
            <link>https://medium.com/@ravirajsubramanian/my-first-task-as-a-developer-advocate-5e446e03b07b?source=rss-a92c7ae1810------2</link>
            <guid isPermaLink="false">https://medium.com/p/5e446e03b07b</guid>
            <category><![CDATA[teamwork]]></category>
            <category><![CDATA[vision]]></category>
            <category><![CDATA[planning]]></category>
            <category><![CDATA[devrel]]></category>
            <dc:creator><![CDATA[Raviraj Subramanian]]></dc:creator>
            <pubDate>Sun, 02 Jun 2024 06:05:11 GMT</pubDate>
            <atom:updated>2024-06-04T06:30:00.696Z</atom:updated>
            <content:encoded><![CDATA[<h3>First mile</h3><p>In just a couple of weeks into the team, it was on a fine afternoon in the daily standup on March 2019, our then manager, <a href="https://x.com/satwikhebbar">Satwik</a> asked us to tackle some prominent issues in the support because our engineering team is spending huge time in support leaving less time to work on the platform.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*p8NuKGcpj2nSRFTJ7OoadQ.jpeg" /><figcaption><a href="https://www.pexels.com/photo/young-game-match-kids-2923/">Photo by Breakingpic</a></figcaption></figure><p>Yes, we had standups in the afternoon. 😃</p><h3>The crew</h3><p>We initially joined the engineering team’s standup. Then, quickly in a week or so, our manager who’s also managing the engineering team realized that the standup is not effective for us and we should have a separate standup.</p><p>There was one Product Marketing Manager and two Tech writers as well in the team. So, among DevRel team, PMs, PMM, and Tech writters joined into a new standup as our work needed more collaboration.</p><h3>Digging the support tickets</h3><p>Okay back to task, I and <a href="https://saifshines.dev/">Saif</a> worked on it as a team. Both of us are quite new to the team. We were advised to audit the last six month’s support tickets and find what are the prominent issues faced by the developer community and come up with action items to resolve them.</p><p>Support tickets via email and chat were landed on Freshdesk support portal and our team handled them on a group in round-robin fashion. We created a Spreadsheet and taken note of the categories of the issues and what was the core issue and what could be a solution. Categories helped us see the pattern of issues and what was trending.</p><h3>Finding the gold</h3><p>I was an experienced developer but new to DevRel. DevRel program is also new at Freshworks. One can also say it as a first test for both I and Saif in this DevRel experimental program.</p><p>We found installing the Freshworks CLI (FDK) as the first prominent issue. It’s still one of the significant problems due to other issues, but that’s a story for a different day. We found some other issues as secondary but solutions for them are unknown or will be more experimental or logistically difficult.</p><p>Next up, we have to find the right solution and execute it.</p><h3>One solution at a time</h3><p>We found installing Node.js with right permissions across different operating systems was the problem. The solution has to be a right fit for the developer audience we had. We found recommending to install Node.js via NVM (Node Version Manager) would be a right solution.</p><p>It’s time to discuss it with our manager.</p><p>Then we had a discussion with Satwik on the cafeteria over coffee. We were very serious about this and planning the strategies on how we can pitch it to our manager. He’s very casual and listening to us over coffee. He just looked at the Spreadsheet to confirm if we see only this as the major problem and quickly said yes and recommended to go ahead. The discussion got over before the coffee.</p><p>He knows this is the major problem by intuition. You can find him often attending support tickets and calls along with his engineers. He anyway wanted us to be data-driven is how I saw it. The solution is a new hypothesis and he wanted us to lead and find out if it works out by taking a risk.</p><p>We were just discussing further on the other ideas to tackle the secondary prominent issues and it went beyond scope as well. When we talk to our manager, he let our minds go wander and get involved in the discussion to curate our thinking so we think beyond scope.</p><h3>Time for action</h3><p>Then we go on to update our documentation to include NVM installation step and how to install Node.js through NVM.</p><p>As our goal, the support tickets drastically reduced on the Freshworks CLI (FDK) installation related issues. We still received some, it was more of exceptions where they never adopted NVM after it was introduced. This is a known set of exceptions.</p><h3>It’s a marathon</h3><p>It was a low-hanging fruit and we were able to easily find and fix it. Further complex issues needed deeper understanding. We continued to participate in the support round-robin and solve the individual tickets along with platform engineers, talked to developers in the community events and support calls, joined one another Developer Advocate who worked on the content and sample code to produce more relevant content for some time.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=5e446e03b07b" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Capitalism Finds a Way: The strategy of moving customers from B2C to B2B]]></title>
            <link>https://medium.com/@ravirajsubramanian/capitalism-finds-a-way-the-strategy-of-moving-customers-from-b2c-to-b2b-e0fe344cb112?source=rss-a92c7ae1810------2</link>
            <guid isPermaLink="false">https://medium.com/p/e0fe344cb112</guid>
            <category><![CDATA[commerce]]></category>
            <category><![CDATA[b2b]]></category>
            <category><![CDATA[economics]]></category>
            <category><![CDATA[capitalism]]></category>
            <dc:creator><![CDATA[Raviraj Subramanian]]></dc:creator>
            <pubDate>Tue, 28 May 2024 18:23:59 GMT</pubDate>
            <atom:updated>2024-05-28T18:23:59.942Z</atom:updated>
            <content:encoded><![CDATA[<h3>The landscape of commerce</h3><p>In the realm of commerce, there are two significant categories that define the flow of money: Business-to-Business (B2B) and Business-to-Consumer (B2C). While B2B transactions often hold the bulk of financial opportunities, convincing consumers to part with their money can be a daunting task, with customer retention posing an ongoing challenge.</p><h3>The intriguing shift</h3><p>Yes, the society has a remarkable capability to steering individuals towards the B2B realm, even when they perceive themselves as mere consumers in the B2C sphere. This transformative process is both intriguing and fundamental to understanding the dynamics of modern capitalism.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*zKgmrvXW2tcVgxXvsVPIcw.jpeg" /><figcaption><a href="https://www.pexels.com/photo/assorted-pens-hanging-9598087/">Photo by Erik Mclean</a></figcaption></figure><p>Imagine you find yourself tasked with selling pens on a street corner. Initially, the prospect of earning commissions for selling items you haven’t manufactured may seem unanticipated. Inspired by this initial success, you invest in a stand to showcase more pens, purchase an umbrella to shield yourself and your merchandise from the sun, and perhaps even allocate funds for marketing endeavors such as banners and offering combo offers.</p><h3>Ripple effect of economic exchange</h3><p>This seemingly productive endeavor not only benefits the pen manufacturer but also extends its ripple effect to the makers of the stand and umbrella. Interestingly, these suppliers need not be industrial giants; they could be fellow individuals engaged in similar entrepreneurial pursuits, thereby extending a cycle of economic exchange.</p><p>This cycle, reminding the industrial age, thrives on the premise of creating demand for goods that individuals might not inherently require. This is an interesting point which I leave you to ponder upon. While you may not personally need hundreds of pens, your involvement in the sales process generates income, thereby fueling economic growth.</p><h3>The essence of capitalism</h3><p>This expansionary trajectory underscores the quintessence of capitalism: the relentless pursuit of wealth generation through the exchange of goods and services. However, this wealth distribution is far from egalitarian, echoing the pervasive reality that equality remains elusive in the capitalist landscape.</p><p>But what if fewer individuals opt to participate in this economic cycle? The ramification repeated to the very core of capitalist ideology, threatening to dismantle the whole web of transactions upon which it thrives. Hence, there exists an absolute necessary to draw more individuals into this economic paradigm.</p><p>Enter B2B transactions — the covert drivers of capitalist expansion. While B2C transactions rely on persuading consumers to view purchases as expenses, B2B transactions capitalize on the notion of investment, thereby enticing entrepreneurs to procure goods and services for their businesses.</p><h3>Change of mission, change of strategy</h3><p>The disparity in marketing strategies between B2C and B2B sectors is telling. While B2C products flood consumers with advertisements (TV ads for example), B2B transactions operate discreetly, targeting a niche audience of business owners primed for investment opportunities while the former primed for consumerism.</p><h3>Innovation helps</h3><p>Moreover, technological breakthroughs serve as catalysts for expanding the reach of capitalism. Each innovation presents an opportunity to integrate more individuals into the economic cycle, thereby amplifying its collective benefits.</p><h3>It’s in the journey, not the destination</h3><p>At its core, capitalism embodies the collective aspirations of its proponents — the capitalists who spearheaded its inception and the multitude who embraced its tenets with hope and passion. Did I just use two Christopher Nolan movies names in one sentence?</p><p>The ultimate objective? To orchestrate a scenario where every individual is a willing participant in the perpetual motion of economic exchange.</p><h3>What’s beyond?</h3><p>As to what lies beyond the universal adoption of capitalism, the possibilities remain clouded in uncertainty. Yet, it is this very ambiguity that guides us to heed and imagine the future trajectory of human civilization and the unstoppable march of capitalism.</p><p>In essence, capitalism finds a way — not merely to survive but to thrive. As we navigate these versions of economic evolution, one question remains: what lies beyond the horizon of capitalism’s pervasive influence? Perhaps it’s a question best left to the collective imagination of humanity itself.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=e0fe344cb112" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Prefer enabling through code over content]]></title>
            <link>https://medium.com/@ravirajsubramanian/prefer-enabling-through-code-over-content-6ec434e16690?source=rss-a92c7ae1810------2</link>
            <guid isPermaLink="false">https://medium.com/p/6ec434e16690</guid>
            <category><![CDATA[tutorial]]></category>
            <category><![CDATA[devrel]]></category>
            <category><![CDATA[documentation]]></category>
            <category><![CDATA[developer-education]]></category>
            <dc:creator><![CDATA[Raviraj Subramanian]]></dc:creator>
            <pubDate>Wed, 10 Apr 2024 03:20:32 GMT</pubDate>
            <atom:updated>2024-04-10T03:20:32.416Z</atom:updated>
            <content:encoded><![CDATA[<p>When it comes to education in programming, code samples are an excellent tool to help learners quickly and effectively understand new concepts. In this blog post, we’ll explore the benefits of using code samples in educational content and provide examples of how they can be used to improve learning outcomes.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*m3g9sOpWU1P4LLrWTuBspQ.jpeg" /></figure><h3>Easy to create, hardly changes</h3><p>One of the most significant advantages of code samples is that they are easy to create. Sometimes, it requires a relevant use case. Sometime, you do not need a use case to provide a sample code.</p><p>Also, you have to refactor the code only when the syntax changes or significant improvements in the programming language. They both usually rarely changes.</p><p>You can observe from <a href="https://github.com/freshworks-developers/data-method-samples/">this sample app code</a> from Freshworks Developer Platform that it’s easy to write this code and it would rarely change.</p><pre> <br>client.data<br>  .get(&#39;loggedInUser&#39;)<br>  .then(function renderUserBioData(payload) {<br>    var {<br>      loggedInUser: {<br>        contact: { name: name, job_title: job, email: email }<br>      }<br>    } = payload;<br>    displayArea.insertAdjacentHTML(<br>      &#39;afterbegin&#39;,<br>      `&lt;p&gt;This is information received from data method:&lt;/p&gt;<br>      &lt;ul&gt;<br>      &lt;li&gt;Name: &lt;mark&gt;${name}&lt;/mark&gt;&lt;/li&gt;<br>      &lt;li&gt;Job Title: &lt;mark&gt; ${job} &lt;/mark&gt;&lt;/li&gt;<br>      &lt;li&gt;Email Address: &lt;mark&gt; ${email} &lt;/mark&gt;&lt;/li&gt;<br>      &lt;/ul&gt;<br>      `<br>    );<br>  })<br>  .catch(console.error);</pre><h3>Cuts through developer segments</h3><p>It can be used across various segments of developers. For example, a beginner programmer may use a sample code snippet to learn a new programming concept, while an experienced developer can use the same code as a starting point for a more complex project.</p><p>Regardless of the experience, all the developers use the sample code snippet from the documentation in their day-to-day development while referring to the documentation.</p><h3>Scannable and copy-pastable</h3><p>Code samples are also scannable, making them easy to read and understand. This is especially helpful for learners who prefer visual aids over text-based content. Additionally, code samples are copy-pastable, allowing learners to quickly and easily integrate the code into their own projects or modify it as needed.</p><p>A documentation that doesn’t have a copy option for the code snippets definitely needs an upgrade. Use the code hosting tools like <a href="https://github.com/">GitHub</a> and <a href="https://codepen.io/">CodePen</a> if you want to achieve it quickly.</p><h3>Learning practically</h3><p>Code samples encourages the developers to get hands-on and learn practically. Learners quickly understand the concepts and work with real-world applications almost immediately. This provides a huge motivation in their learning journey and you step ahead in your goal as the enabler as well.</p><h3>Easy to test</h3><p>As developers get hands-on, it becomes easier to quickly test the code they have just learned. It’s easy to identify any errors with comparing the code. This testing process can help learners develop their troubleshooting skills and become more proficient in programming. This is another great leap for you as an enabler.</p><h3>Positive influence</h3><p>Code samples can have a positive influence on learners by demonstrating that something is possible. By working with sample code, learners can see firsthand how a programming concept can be applied in practice and gain the motivation to pursue more advanced projects.</p><h3>Which samples to write first?</h3><p>Firstly, prefer the feature-parity and then cover frequent use-cases. This means starting with basic functionality and then gradually adding more complex features as learners become more confident in their abilities.</p><p>Use-case-based sample code may not provide some of the advantages discussed above. For example, they would require changes frequently when the use-case needs a change.</p><h3>How Freshworks invested in sample code</h3><p>When writing this blog post, I work as a Developer Advocate for <a href="https://freshworks.com/">Freshworks</a>. Freshworks, a leading software product company, has invested heavily in code samples as part of their educational content strategy for it’s <a href="https://freshworks.dev/">Developer Platform</a>. By providing sample code for a wide range of programming languages and tools, Freshworks has created an extensive monorepo of sample apps that can be easily maintained and updated by a small team.</p><h3>A monorepo full of sample apps code</h3><p>The monorepo used by Freshworks includes sample apps for all the features covered in their educational content. This approach allows developers to easily refer back to the initial adopters and make updates as needed.</p><h3>Separate repositories for hands-on tutorials and workshop materials</h3><p>As the educational content evolved, Freshworks moved from a monorepo to <a href="https://github.com/freshworks-developers/">a GitHub organisation</a> with separate repositories for each sample app. This approach allows developers to build hands-on tutorials and workshop materials that can be cloned and tried out in parallel.</p><p>In conclusion, code samples are an excellent tool for educational content for their advantages across the enablement cycle. By incorporating code samples into your educational content, you can help learners gain a deeper understanding of the concepts and become practical while also achieving your goals faster in enabling them with lesser efforts.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6ec434e16690" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Security measures for internet world]]></title>
            <link>https://medium.com/@ravirajsubramanian/security-measures-for-internet-world-31b343da88d2?source=rss-a92c7ae1810------2</link>
            <guid isPermaLink="false">https://medium.com/p/31b343da88d2</guid>
            <category><![CDATA[internet]]></category>
            <category><![CDATA[cybersecurity]]></category>
            <dc:creator><![CDATA[Raviraj Subramanian]]></dc:creator>
            <pubDate>Sat, 02 Mar 2024 18:31:10 GMT</pubDate>
            <atom:updated>2024-03-02T18:31:10.275Z</atom:updated>
            <content:encoded><![CDATA[<p>Increasingly, we are all using the internet directly or indirectly through other mediums who use the internet. We may have to take additional steps to ensure the safety and security of our data and ourselves as we do in the physical world with security measures like lockers, gates, doors, surveillance cameras, and so on.</p><figure><img alt="A security camera shown as a secure space with continiuous monitoring." src="https://cdn-images-1.medium.com/max/1024/1*emP5-bkrxe9vunXXByspZA.jpeg" /><figcaption><a href="https://www.pexels.com/photo/grayscale-photo-of-barbed-wire-274886/">Photo by Pixabay from Pexels</a></figcaption></figure><p>The touch points of the internet are becoming more expansive with multiple devices used day-to-day. Every one of us is using at least a mobile phone, a telecom carrier, a personal/work computer, and a television, which are connected to the internet. They all represent ourselves on the internet. Also, indirectly, we get exposed through other mediums used by others like shopping malls and supermarkets billing computers, vehicles, government systems and identities, and workplaces.</p><p>Take these measures to keep yourself safe and secure your data on the internet which can affect you in the long run if not kept secure.</p><h3>1. Use a Password Manager🛡️</h3><ul><li>Password managers like Bitwarden provide a secure way to manage passwords. Utilize the manager to generate complex, unique passwords for each account.</li><li>Remember only one strong master password for the manager, enhancing overall security.</li></ul><h3>2. Implement Two-Factor/Multi-Factor Authentication 🔐</h3><ul><li>Enable 2FA/MFA on all applicable accounts, especially email and social media.</li><li>Choose separate authenticator apps, like Microsoft Authenticator, for added security.</li></ul><h3>3. Limit Personal Information Sharing 🤐</h3><ul><li>Avoid sharing unnecessary personal information online.</li><li>Be cautious about the data you share, especially on social media platforms.</li></ul><h3>4. Minimize Online Presence🕵️‍♂️</h3><ul><li>Hide as much personal information as possible.</li><li>Restrict social media privacy settings to your preferred personal data exposure. For example, hide your data of birth where unnecessary.</li></ul><h3>5. Deactivate Dormant Accounts 🚫</h3><ul><li>Periodically review and deactivate unused accounts.</li><li>Follow the user’s example of deleting dormant accounts to reduce the risk of unauthorized access.</li></ul><h3>6. Protect Aadhaar Information 🇮🇳</h3><ul><li>For users in India, safeguard Aadhaar information.</li><li>Avoid unnecessary exposure online and consider using a virtual Aadhaar for temporary verification.</li></ul><h3>7. Secure Data Backups ☁️</h3><ul><li>Backup data only in trusted locations.</li><li>Ensure cloud accounts are well-protected, and regularly review and delete unnecessary backups.</li></ul><h3>8. Enable SIM PIN 📱</h3><ul><li>Protect your cellphone carrier account by activating your SIM pin to prevent SIM-swap security attacks.</li><li>It will protect you when the phone is stolen or acquired your phone number in a new SIM card in any other way mandates entering the SIM PIN to activate your phone number.</li></ul><p>With these security measures, we can feel safe online as well.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=31b343da88d2" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[The Journey of 0-to-1 in Content Strategy]]></title>
            <link>https://medium.com/@ravirajsubramanian/the-journey-of-0-to-1-in-content-strategy-d9051865ca28?source=rss-a92c7ae1810------2</link>
            <guid isPermaLink="false">https://medium.com/p/d9051865ca28</guid>
            <category><![CDATA[content-writing]]></category>
            <category><![CDATA[content-strategy]]></category>
            <category><![CDATA[devrel]]></category>
            <category><![CDATA[video-production]]></category>
            <dc:creator><![CDATA[Raviraj Subramanian]]></dc:creator>
            <pubDate>Mon, 11 Dec 2023 18:47:28 GMT</pubDate>
            <atom:updated>2023-12-11T18:49:03.220Z</atom:updated>
            <content:encoded><![CDATA[<p>Hint: It’s a no-metrics zone.</p><p>In the journey from 0 to 1, where time is a precious resource, the balance between content creation and metrics is crucial. Let’s explore how to navigate this delicate equilibrium.</p><figure><img alt="An writer writing on a notebook sitting on a beach alone." src="https://cdn-images-1.medium.com/max/1024/1*Z7A5w8Zct0Gn56d7N51NmA.jpeg" /><figcaption><a href="https://www.pexels.com/photo/man-writing-in-notebook-on-a-beach-19357862/">Photo by Bruno Brandao</a></figcaption></figure><h3>The Early Stage: Metrics Shouldn’t Guide, but Enlighten</h3><p>In the initial phase, focus on creating content without being overly concerned about metrics. The goal is to take that first step, produce valuable material, and establish a foundation.</p><p>Constantly measuring every detail too early can be counterproductive. Metrics should not dictate your every move but rather provide insights to challenge assumptions and hypotheses.</p><h3>Iterate and Reflect</h3><p>Instead of micromanaging with constant measurements, schedule periodic reflections, say once in a month or a quarter. This allows for a more comprehensive analysis of progress without overwhelming daily tracking.</p><p>If engagement is lacking, consider positive pivots. For instance, experimenting with different content formats, like short videos over long video formats, based on observed engagement trends.</p><h3>Freshworks Developer Platform Case Study</h3><p>The case study involves diversifying content formats but facing challenges in contributing to content with broader reach.</p><h4><strong>Identifying an Easier Medium</strong></h4><p>Recognizing the need for an easier medium, I introduced knowledge base articles on our community platform, combining better reach with ease of contribution.</p><h4><strong>Frequency and SEO</strong></h4><p>A strategic decision to publish articles frequently on the new platform with excellent SEO results in a compounding effect on reach. At some point, our team has contributed in the range of an article every day.</p><h4><strong>Metrics-driven Approach</strong></h4><p>After a significant number of articles, we dived into analytics to measure engagement, user attraction, support ticket reduction, and identifying the content gaps.</p><p>Based on metrics, we adjusted the content creation frequency and type, optimizing for sustained engagement.</p><h3>From 1 to N: The Role of Metrics Evolves</h3><p>As the initiative progresses from 0 to 1 and beyond, metrics evolve from being an occasional tool to a necessary guide in understanding audience behavior and refining strategies.</p><p>Early concerns about missing out on metrics were, in hindsight, beneficial. It allowed our team to focus on content creation before diving into detailed measurements.</p><p>In essence, the early stages require a focus on content creation, with metrics serving as occasional guides rather than strict rulers. Over time, strategic reflections, positive pivots, and metrics-driven adaptations become essential for sustained success.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=d9051865ca28" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Streamlining your app publishing journey for the Freshworks Marketplace: a step-by-step guide]]></title>
            <link>https://medium.com/freshworks-developer-blog/streamlining-your-app-publishing-journey-for-the-freshworks-marketplace-a-step-by-step-guide-c96a0cd0ce51?source=rss-a92c7ae1810------2</link>
            <guid isPermaLink="false">https://medium.com/p/c96a0cd0ce51</guid>
            <category><![CDATA[marketplace-app]]></category>
            <category><![CDATA[app-development]]></category>
            <category><![CDATA[freshworks]]></category>
            <category><![CDATA[best-practices]]></category>
            <dc:creator><![CDATA[Raviraj Subramanian]]></dc:creator>
            <pubDate>Mon, 17 Apr 2023 11:12:56 GMT</pubDate>
            <atom:updated>2023-04-17T11:12:56.830Z</atom:updated>
            <content:encoded><![CDATA[<p>The traditional software development life cycle often involves exploring, experimenting, and publishing on a hosting platform or self-hosting. However, a more efficient and streamlined approach to developing and delivering software applications is growing. At Freshworks, we have optimized our developer platform processes to provide app developers with a seamless experience, making building, and publishing their apps more straightforward and efficient.</p><p>This article offers guidance on publishing apps on the <a href="https://www.freshworks.com/apps/">Freshworks Marketplace</a> and clarifies the various steps involved in the process. From planning and documentation to testing, validation, and submission, we’ll walk you through each stage in the process and provide tips and best practices. Whether you’re a seasoned app developer or just starting, this guide will help you optimize your workflow and get your apps published on the Freshworks Marketplace in no time.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*SI1uTCUyGIPS-7ge" /><figcaption>Credits: <a href="https://www.pexels.com/photo/cheerful-multiethnic-friends-with-laptop-raising-hands-in-success-3866512/">Photo by Andrea Piacquadio on Pexels</a></figcaption></figure><p>Publishing an app to the Freshworks Marketplace may involve a few steps that require attention, especially for those who are new to the process. Let’s divide this journey into five stages and examine the steps in each of them. These steps will help chart out a seamless app publishing process for you.</p><h3>Stage 1: Planning</h3><p>Before starting the app development process, consider working on the following actions to plan the app requirements.</p><h4>Maintain documentation</h4><p>Documentation is the technical journal of an app. Write and regularly update documentation for your app, including its use case, solution, design, and caveats. You can do the documentation in the app’s readme file or an internal knowledge base.</p><p>This documentation should provide the necessary information to begin app development, address team member queries, and assist future work on the app. Take a look at <a href="https://github.com/freshworks-developers/sentimental-jeff-app#readme">the sample documentation for a Freshdesk app</a>.</p><h4>Use diagrams</h4><p>While you may have written comprehensive documentation for your app, gaps in functionalities may appear during the actual app development process. To avoid this, consider creating a <a href="https://en.wikipedia.org/wiki/Flowchart">flowchart</a> or <a href="https://en.wikipedia.org/wiki/Website_wireframe">wireframe</a> of the app’s user interface (UI) before starting the app development process.</p><p>These diagrams can help you identify potential gaps in functionality. This ‘virtual’ app development process can save time and improve the final product’s quality.</p><h3>Stage 2: App development</h3><p>During your app development phase, consider the following actions to ensure your app is error-free before submitting it to the Freshworks Marketplace.</p><h4>Use Version Control System (VCS)</h4><p>Consider using a cloud-based or self-hosted version control system, such as <a href="https://git-scm.com/">Git</a>. VCS can help you track the development of your project across different streams (branches). With VCS, you can upload your code at any milestone and easily switch back and forth between these milestones using branches.</p><h4>Use .gitignore file</h4><p>Use <a href="https://git-scm.com/docs/gitignore">a .gitignore file</a> to prevent unnecessary files from being uploaded to your version control system.</p><p>For example, the <em>.fdk/localstore</em> file contains the secure installation parameters, and you should ignore it while uploading your app code to VCS.</p><p>You can generate the <em>.gitignore</em> file for your Freshworks app using the <em>fdk generate</em> command. Here’s an example of a typical <em>.gitignore</em> file for Freshworks apps:</p><pre>.DS_Store<br>.fdk/<br>coverage/<br>.report.json<br>.vscode/<br>node_modules/<br>test_data/<br>dist/<br>config/iparam_test_data.json<br>log/</pre><h4>Use the latest software version</h4><p>Ensure that you are using the latest version of FDK (Freshworks Development Kit) and its supported Node.js version. Freshworks apps are built with the help of <a href="https://developer.freshdesk.com/v2/docs/quick-start/#install_the_cli">Freshworks CLI (FDK)</a>; it runs on Node.js runtime and is a tight dependency. You can use a Node.js version manager such as <a href="https://github.com/nvm-sh/nvm#readme">nvm</a> to easily switch to a compatible node version and upgrade it as needed.</p><p>This practice helps you stay up-to-date with our security updates and resolves other issues in your local development environment by upgrading when updates become available.</p><h4>Perform validation</h4><p>Validate your app source code using the <a href="https://developer.freshdesk.com/v2/docs/freshworks-cli/#validate">fdk validate</a> command. This command will display errors or warnings related to your app source code and package.</p><h4>Test the app</h4><p>To ensure quality, thoroughly test the app every time changes are made before submitting it.</p><p>Keep the code coverage of the app as high as possible for assurance, aiming to generate at least 80% code coverage through manual or automatic testing before submitting it to the Freshworks Marketplace.</p><h3>Stage 3: App submission</h3><p>Once your app has been developed and is ready for submission, consider taking the following actions before submitting your app to Freshworks.</p><h4>Perform grammar check</h4><p>Perform a comprehensive grammar check on the app listing details, including the overview, description, and instructions. You can use tools like <a href="https://grammarly.com/">Grammarly</a> and <a href="https://hemingwayapp.com/">Hemingway</a> to detect grammar mistakes and improve readability.</p><h4>Check app bundling</h4><p>If your app is minified, ensure that you keep the original source code in the `<em>src</em>/` folder located at the root of the app. This will allow app reviewers to check your app and skip the mandatory code coverage check, which is required for non-minified apps.</p><p>This process applies to apps built with frontend frameworks such as Typescript, React, Vue, and others that require the transpiling and compiling of the source code.</p><h4>Prepare supporting content/video</h4><p>When submitting your app to publish on the Freshworks Marketplace, it is essential to include a demo video or a specification document for the initial submission and for each subsequent update.</p><p>Therefore, before submitting your app, you should prepare a demo video or a specification document that highlights the following information:</p><ul><li>List of prerequisites required before installing your app.</li><li>Features of your app.</li><li>Steps to configure and use your app.</li><li>Demonstration of each functionality, including edge cases.</li><li>Possible scenarios of what happens if the app is uninstalled.</li></ul><p>This information will help the Freshworks app review team to understand your app’s code, functionality, and listing details.</p><h4>Prepare instructions for configuration</h4><p>To make it easy for users to configure your app, document the details required to set it up. You can then add these details to the ‘<strong>Instructions’</strong> field on the app submission page when submitting your app. This practice will help avoid any potential issues for users when installing your app.</p><h4>Prepare instructions on dependencies</h4><p>When documenting instructions for your app, include information about the higher-plan product features that the app relies on, as well as the required product API rate limit and platform rate limit for a given amount of traffic. This practice will significantly reduce the number of support requests from customers.</p><h4>Here is an example of a calculation for a sample scenario for an app in Freshdesk/Freshservice:</h4><p>Agents/Users: 200</p><p>Possible concurrent agents/users: 100</p><p>Expected Ticket Traffic per hour: 1000</p><p>Expected ticket traffic per minute: 1000/60 = ~20</p><p><strong>Product API and Platform features used:</strong></p><p>Serverless event (Ticket creation): 2 HTTP requests via Request Method, 1 Data Storage operation.</p><p>Frontend actions: The agent might ignite a feature that would make 1 HTTP request via Request Method and 1 Data Storage operation.</p><p><strong>Required rate-limit:</strong></p><p>Request Method for HTTP requests: (20*2 = 40) + (100*1 = 100) = 140 (Default rate-limit: 50)</p><p>Data Storage: (20*1 = 20) + (100*1 = 100) = 120 (Default rate-limit: 50)</p><blockquote><strong>Note</strong>: These numbers are for an example. You should calculate relevant metrics for your app and account.</blockquote><h4>Select the appropriate product</h4><p>When submitting an app to Freshworks, make sure that you are logged into the corresponding product’s marketplace. For instance, if you attempt to submit a Freshdesk Contact Center-based app on Freshchat’s marketplace, it will result in delays and possible rejections of your app submission.</p><h3>Stage 4: App review</h3><p>The app review team will provide appropriate feedback if the app fails to meet specific criteria. The essential criteria for successful app submission are <a href="https://developer.freshdesk.com/v2/docs/code-review-guidelines/">the code review guidelines</a> and <a href="https://developer.freshdesk.com/v2/docs/app-content-guidelines/">app content guidelines</a>. They aim to ensure that all the app core functionalities are working and are validated with FDK.</p><p>You may need to resubmit the app based on the feedback.</p><p>To ensure a smooth resubmission of your app, consider taking the following actions:</p><h4>Work on feedback</h4><p>Freshworks uses its own project management tool, Freshrelease, to share app review feedback with app developers. You will receive a link to join and view the feedback when it becomes available.</p><p>Once you receive feedback from the app reviewers, promptly address the issues, and make changes to your app. This will help expedite the publishing process.</p><blockquote><strong>Note</strong>: Freshworks does not provide a specific timeline for addressing feedback and resubmitting the app. It is left to the app developer to decide when to submit the app again after addressing the feedback.</blockquote><p>If you receive partial app review feedback, take the time to address the issues even if the complete feedback and app review status are still pending. You can submit the app again with complete feedback when it is rejected.</p><h4>Ask queries on app review</h4><p>If you have any questions regarding app submission or review feedback, you can respond in the same email thread or Freshrelease ticket. Alternatively, you can request the status of your app submission on <a href="https://dev-assist.freshworks.com/a/catalog/items/49">our Dev-Assist portal</a>.</p><h3>Stage 5: App maintenance</h3><p>After publishing your app, it’s crucial to take the necessary steps to keep the information about yourself and your app up-to-date. Consider the following actions during the app maintenance phase.</p><h4>Update contact information</h4><p>Make sure to keep your support and alternate emails up-to-date. These contact details will be used for all communications regarding your app submission, review, and support.</p><h4>Update app listing details</h4><p>It’s necessary to regularly update the app listing details to communicate the functionality to your users in the Freshworks Marketplace. In the event that changes are made only to the app listing (and not the app source code), the updates will simply go through a content review before the changes are taken live.</p><h4>Perform active maintenance</h4><p>It is important to periodically update your app, especially when platform security or feature updates are available. An updated app will attract more customer adoption and result in fewer support requests.</p><p>You can sign up for<a href="https://community.freshworks.dev/c/happening/announcements/12"> the Freshworks Developer community forum</a> to receive regular announcements and releases to stay up-to-date.</p><p>Overall, adhering to these effective strategies can simplify the process of developing and submitting an app on the Freshworks Marketplace. Leverage the support provided and prioritize quality by ensuring thorough testing, documentation, and code coverage. With dedication and attention to detail, you will be able to successfully publish an app in no time.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=c96a0cd0ce51" width="1" height="1" alt=""><hr><p><a href="https://medium.com/freshworks-developer-blog/streamlining-your-app-publishing-journey-for-the-freshworks-marketplace-a-step-by-step-guide-c96a0cd0ce51">Streamlining your app publishing journey for the Freshworks Marketplace: a step-by-step guide</a> was originally published in <a href="https://medium.com/freshworks-developer-blog">Freshworks Developer Platform Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Reconsidering jQuery]]></title>
            <link>https://medium.com/freshworks-developer-blog/reconsidering-jquery-a451a3869557?source=rss-a92c7ae1810------2</link>
            <guid isPermaLink="false">https://medium.com/p/a451a3869557</guid>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[html]]></category>
            <category><![CDATA[css]]></category>
            <category><![CDATA[vulnerability]]></category>
            <category><![CDATA[jquery]]></category>
            <dc:creator><![CDATA[Raviraj Subramanian]]></dc:creator>
            <pubDate>Tue, 02 Feb 2021 05:22:38 GMT</pubDate>
            <atom:updated>2021-02-02T05:37:22.825Z</atom:updated>
            <content:encoded><![CDATA[<p>There’s no disagreeing on how useful <a href="https://jquery.com/">jQuery</a> is as a powerful utility library. In recent years however, increasingly new exploits and vulnerabilities have been reported around jQuery. This forces us to reconsider if and how to use jQuery. jQuery continues to be one of the popular ways to manipulate on-screen experiences, with our <a href="http://community.developers.freshworks.com/">Freshworks developer community</a> as well. Today we would like to encourage you, as app developers, to start moving away from jQuery-based solutions. In this blog post, we speak about how you could achieve that.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*PCUtINjf8-WAdIfcYkpYwg.jpeg" /><figcaption>Photo credit: <a href="https://unsplash.com/@dollargill">@dollargill</a> on <a href="https://unsplash.com/">Unsplash</a></figcaption></figure><h3><strong>The dawn of jQuery</strong></h3><p>jQuery was released in 2006 and quickly became the go-to JavaScript library for web developers. A number of other libraries such as<a href="https://mootools.net/"> MooTools</a> and<a href="http://prototypejs.org/"> Prototype</a> came around the same time but jQuery outlasted them. At the time of writing this article, jQuery has over 3 million weekly downloads, on average, on<a href="https://www.npmjs.com/package/jquery"> NPM</a> and over 16,000 NPM packages depending on it.</p><p>As a developer, you are likely to have used jQuery at some point in your career. Its selling point is the simplicity it offers in crafting web experiences. In some cases, this simplicity also hurts our interests as web developers.</p><h3><strong>The problem</strong></h3><p>If you do use jQuery and don’t remember upgrading it recently, you are probably using a vulnerable version.</p><p>In terms of current usage, the legacy version jQuery 1.x dominates when compared to later versions such as 2.x and 3.x. A number of <a href="https://snyk.io/vuln/npm:jquery">known vulnerabilities</a> have been reported with the older versions of jQuery. An <a href="https://snyk.io/vuln/SNYK-JS-JQUERY-567880">XSS vulnerability</a> found with a very early version was fixed with version 3.5.0.</p><p>Potential issues with jQuery are not quite obvious. With the simplicity of jQuery, comes the ignorance of danger. For example, there exists <a href="https://api.jquery.com/jQuery">a utility function</a> that can perform different operations depending on the parameter passed to it. Depending on the string parameter, the function figures out if it is working with HTML code or a selector to create an element dynamically or selecting an existing HTML element. As a side-effect, it introduced an XSS vulnerability that was eventually fixed in the version 1.9 (released in 2013). It took years before most websites migrated to a safe version of jQuery, additionally made harder because the fixed version was backwards incompatible.</p><p>Some of the other vulnerable methods include jQuery.parseHTML() and jQuery.ajax(). jQuery Ajax auto-detects the response type, including HTML, using the MIME type provided by the server when content type is not explicitly mentioned. This means that attackers could inject HTML into the selector and trick jQuery into substituting the safe “find element” operation with a potentially dangerous “create a new element” operation that refers to untrusted data sources. A side-effect of the latter would be the execution of malicious JavaScript code, a typical client-side <a href="https://en.wikipedia.org/wiki/Cross-site_scripting">XSS vulnerability</a>. We recommend <a href="https://palant.info/2020/03/02/psa-jquery-is-bad-for-the-security-of-your-project/#the-danger-of-simple">this post</a> for a deeper dive on this topic.</p><p>The jQuery API documentation does not help assess the the degree of impact the innocent use of any of the methods may cause. This is left to the developer’s sense of awareness. With so many patches and updates being released all the time, expecting developers to be aware of each one of them is hardly reasonable.</p><p>XSS attacks, for example, are so dangerous that even a mild hint to a developer about giving a second thought before using a method in a particular way, is definitely worth it. For example, ReactJS makes it explicit even in their API naming schemes. See <a href="https://reactjs.org/docs/dom-elements.html#dangerouslysetinnerhtml">dangerouslySetInnerHTML</a>.</p><p>The simplicity jQuery provides to us developers is very welcome. But it is only safe to use it after we understand all the inherent pitfalls and handle them in our applications, especially before passing raw parameters and using raw data from external resources, such as user inputs.</p><h3>The solution</h3><h4>Selectors</h4><p>Selecting elements is the primary use of jQuery. One solution to our jQuery related problems is to avoid including the whole library just to use a feature such as <a href="https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelector">Document.querySelector</a>().</p><p>You could also replace some of the common jQuery selectors right away using the following snippets.</p><ul><li>$(&#39;body&#39;) =&gt; document.body</li><li>$(&#39;html&#39;) =&gt; document.documentElement</li><li>$(&#39;.button&#39;) =&gt; document.querySelector(&#39;.button&#39;)</li><li>$(&#39;#id&#39;).find(&#39;.button&#39;) =&gt; document.getElementById(&#39;id&#39;).querySelector(&#39;.button&#39;)</li><li>$(&#39;#id&#39;).parent() =&gt; document.getElementById(&#39;id&#39;).parentNode</li><li>$(&#39;#id&#39;).closest(&#39;.country&#39;) =&gt; document.getElementById(&#39;id&#39;).closest(&#39;.country&#39;)</li><li>$(&#39;#input&#39;).closest(&#39;form&#39;) =&gt; document.getElementById(&#39;input&#39;).form</li><li>$(&#39;#id&#39;).prev() =&gt; document.getElementById(&#39;id&#39;).previousElementSibling</li><li>$(&#39;#id&#39;).next() =&gt; document.getElementById(&#39;id&#39;).nextElementSibling</li></ul><h4>HTTP requests</h4><p>You don’t need to use jQuery Ajax to make HTTP requests from your app. Browsers today support the <a href="https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API">Fetch API</a> that works equally well. To bypass CORS, the <a href="https://developer.freshdesk.com/v2/docs/request-api">Request API</a> from the Freshworks platform comes to the rescue.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/7e1da55dc39ac741b25057efb0be294b/href">https://medium.com/media/7e1da55dc39ac741b25057efb0be294b/href</a></iframe><h4>Web APIs</h4><p>jQuery was introduced at a time when browser interfaces and <a href="https://developer.mozilla.org/en-US/docs/Web/API">Web APIs</a> were hardly uniform. These inconsistencies have been incrementally addressed in the more recent Javascript versions that are widely supported by most browsers today. If you primarily care about the simplicity of DOM manipulation, we recommend lighter, specialized libraries such as<a href="http://jbone.js.org/"> jBone</a> or <a href="https://github.com/dkraczkowski/dom.js">DOM.js</a>.</p><p>Here are a few further examples of how to replace more common uses of jQuery:</p><p><strong>Document ready</strong></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/06f621b493da7fa3a809d99aedf68a94/href">https://medium.com/media/06f621b493da7fa3a809d99aedf68a94/href</a></iframe><p><strong>Classes</strong></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/ab3b18aee2e769ebc0f75504e032a333/href">https://medium.com/media/ab3b18aee2e769ebc0f75504e032a333/href</a></iframe><p><strong>Create element</strong></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/2d38c9cd43f56d6fca9d16af32e1eab9/href">https://medium.com/media/2d38c9cd43f56d6fca9d16af32e1eab9/href</a></iframe><p><strong>Add content safely to elements</strong></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/a0569d4fa03193e13ffc37fd724a2626/href">https://medium.com/media/a0569d4fa03193e13ffc37fd724a2626/href</a></iframe><h4>CSS</h4><p>CSS element selectors and animations have indeed been addressed cleverly by jQuery since its early days. CSS animations can today be achieved with <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Animations">plain CSS</a> or lightweight CSS animation libraries such as <a href="https://github.com/animate-css/animate.css">Animate.css</a> and <a href="https://github.com/juliangarnier/anime">anime.js</a>.</p><p>A few common examples follow.</p><p><strong>Inline CSS</strong></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/2cfcb2afc64e4b3857106d05b197a957/href">https://medium.com/media/2cfcb2afc64e4b3857106d05b197a957/href</a></iframe><p><strong>Hide/Show</strong></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/f42dc85fb82ed88f1a764029b1be02c1/href">https://medium.com/media/f42dc85fb82ed88f1a764029b1be02c1/href</a></iframe><p><strong>Fade In</strong></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/c544f79f2a3031824f4bd44f3c014962/href">https://medium.com/media/c544f79f2a3031824f4bd44f3c014962/href</a></iframe><p><strong>Fade Out</strong></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/16db7ecf54b35668def7f547b79d320f/href">https://medium.com/media/16db7ecf54b35668def7f547b79d320f/href</a></iframe><h4><strong>Dynamic interfaces</strong></h4><p>For dynamic interfaces, vanilla JS supports <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals">template literals</a> which can be used effectively with finer grained control. When only minor changes are needed to the HTML component structure, <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/template">the template tag of HTML</a> can be used.</p><p>When things get more complex, template engines such as <a href="https://handlebarsjs.com/">Handlebars</a> and <a href="https://jade-lang.com/">Jade</a> can be used as safe alternatives to achieve the same.</p><h3>It’s Time</h3><p>Looking at all these alternatives and options, it’s obvious that jQuery is no longer the easiest way of working with DOM, as vanilla JS evolves to support the same level of ease along with being a more secure option. Today, all apps can be developed without using jQuery. When building new <a href="https://www.freshworks.com/apps">Freshworks apps</a>, let’s avoid using jQuery. For existing apps, we can refactor the code to replace jQuery functions with its alternatives. We have already done this with <a href="https://github.com/freshworks/marketplace-sample-apps">our own samples</a>.</p><p>If you run into any roadblocks while at this, we are happy to discuss them with you on our <a href="http://community.developers.freshworks.com/">Freshworks developer community</a>.</p><h3>References</h3><ol><li><a href="https://www.cvedetails.com/vulnerability-list/vendor_id-6538/Jquery.html">https://www.cvedetails.com/vulnerability-list/vendor_id-6538/Jquery.html</a></li><li><a href="https://snyk.io/vuln/npm:jquery">https://snyk.io/vuln/npm:jquery</a></li></ol><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=a451a3869557" width="1" height="1" alt=""><hr><p><a href="https://medium.com/freshworks-developer-blog/reconsidering-jquery-a451a3869557">Reconsidering jQuery</a> was originally published in <a href="https://medium.com/freshworks-developer-blog">Freshworks Developer Platform Blog</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Clean Code, What? and Why?]]></title>
            <link>https://medium.com/@ravirajsubramanian/clean-code-what-and-why-141bfa788c19?source=rss-a92c7ae1810------2</link>
            <guid isPermaLink="false">https://medium.com/p/141bfa788c19</guid>
            <category><![CDATA[code]]></category>
            <category><![CDATA[bugs]]></category>
            <category><![CDATA[agile]]></category>
            <category><![CDATA[developer]]></category>
            <dc:creator><![CDATA[Raviraj Subramanian]]></dc:creator>
            <pubDate>Thu, 23 Jul 2020 03:58:27 GMT</pubDate>
            <atom:updated>2020-07-23T04:10:07.398Z</atom:updated>
            <content:encoded><![CDATA[<h3>What is clean code?</h3><p>Well, Ideally, a properly written code by a professional is what is called as clean code.</p><blockquote><em>Writing clean code is what you must do in order to call yourself a professional. There is no reasonable excuse for doing anything less than your best. — Robert C. Martin</em></blockquote><p>How is it written will be covered in the latter part of this series. Let’s see why is it important and what advantage does it provide you, your company, and your future self. 😉</p><p>Clean code in a project provides efficiency to the engineers over the time that it makes it easier to make changes in the future, easier to troubleshoot bugs, easier to add or remove a particular component without side-effects and there are a lot more advantages.</p><blockquote><em>The code easier to read is easier to write.</em></blockquote><p>Everybody has deadlines. Everybody has a client or customer who wants the code to be deployed soon. You’re responsible for the code, not your boss, not your customer.</p><blockquote><em>We like to think that we mostly do power typing. But we actually do is staring at the Abyss. — Douglas Crockford</em></blockquote><p>We may think we are going fast by skipping certain principles of coding and agile methodology. But, we are actually going slow.</p><p>Before the application gets released, there will be bugs while testing the application for usability. We will go back to fix the bugs. There will be multiple releases for each bug fix cycle.<br> Considering this fact, dirty code has more cost with respect to time. To say the truth, it actually takes more time than writing clean code.</p><p>As a matter of fact, the ratio of time spent reading code versus writing is well over 10 to 1.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/500/1*5RhyUqWmrXugwrjchoA5rA.jpeg" /><figcaption>Code review scenario</figcaption></figure><p>It’s the “craftsmanship” that puts you behind the left door.</p><blockquote><em>There are two parts to learning craftsmanship: knowledge and work. You must gain the knowledge of principles, patterns, practices, and heuristics that a craftsman knows, and you must also grind that knowledge into your fingers, eyes, and gut by working hard and practicing. — on the book, Clean Code by Robert C. Martin (Uncle Bob)</em></blockquote><p>Take doctors, for example. Will you accept for them to skip a few practices like washing hands before surgery?<br> For accountants to skip copying certain records for auditing purposes?</p><p>Every professionals follow their own set of principles and practices. Being professional is what makes a clean code possible.</p><blockquote><em>“It is not enough for code to work.” — Robert C. Martin</em></blockquote><figure><img alt="" src="https://cdn-images-1.medium.com/max/600/1*wcOglO55wmZFbjd6RUpbHA.jpeg" /><figcaption>Being professional</figcaption></figure><p>What impacts a dirty code has?</p><ul><li>It gets difficult to maintain the code. Remember the <a href="https://en.wikipedia.org/wiki/Open-closed_principle">Open-Closed principle</a>.</li><li>As it is difficult to add features, the project backlog grows and slows down the application releases.</li><li>Over time, it results in poor performance of the application.</li><li>New developers joining the project get confused while reading the code to work on it.</li><li>You or your company may end up losing the contract of the client.</li><li>Poorly written code welcomes security breaches.</li></ul><blockquote><em>First, it is through practice in the small that professionals gain proficiency and trust for practice in the large. Second, the smallest bit of sloppy construction, of the door that does not close tightly or the slightly crooked tile on the floor, or even the messy desk, completely dispels the charm of the larger whole. That is what clean code is about. — James O. Coplien</em></blockquote><p>In painting, knowing the difference between the good art paint to the bad one does not mean we know how to paint. In the same way, the ability to differentiate clean code with the dirty code does not mean we know how to write clean code.</p><p>In the following articles in this series, let’s see how to write clean code by following certain practices, follow a checklist of a professional, and how each of them will help for the better.</p><p><em>Originally published at </em><a href="https://dev.to/ravirajthedeveloper/clean-code-what-and-why-4ep6"><em>https://dev.to</em></a><em> on July 23, 2020.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=141bfa788c19" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Build a resume in the right way.]]></title>
            <link>https://medium.com/@ravirajsubramanian/build-a-resume-in-the-right-way-cd5f506172d4?source=rss-a92c7ae1810------2</link>
            <guid isPermaLink="false">https://medium.com/p/cd5f506172d4</guid>
            <category><![CDATA[cv]]></category>
            <category><![CDATA[resume]]></category>
            <category><![CDATA[interview]]></category>
            <category><![CDATA[careers]]></category>
            <dc:creator><![CDATA[Raviraj Subramanian]]></dc:creator>
            <pubDate>Sun, 10 May 2020 08:33:49 GMT</pubDate>
            <atom:updated>2020-05-10T08:49:38.275Z</atom:updated>
            <content:encoded><![CDATA[<p>Why does it important to build a resume in the first place? What is the right way? Is it the same everywhere and for everyone?</p><p>Before jumping in to answer these questions, let’s understand what does resume even means.</p><p>The resume is a summary or a short form of <a href="https://en.wikipedia.org/wiki/Curriculum_vitae"><em>curriculum vitae (CV)</em></a> which means “ <em>course of life</em>” in Latin. So, it is a comprehensive overview of professional or educational history. Unlike a CV, the resume will only contain recent professional highlights in short notes.</p><p>Thank you, <a href="https://ladybug.dev/">LadyBug podcast</a> hosts, for motivating me to write this blog and given most of these details on <a href="https://ladybug.dev/resumes">an episode</a>. 🙏</p><p><strong>Back to the original question, why is it important to build a resume?</strong></p><p>Imagine buying a T-shirt. But, instead of looking at it yourself, based on what shopkeeper tell you, how this T-shirt will look like, what design it has, what cloth material it is, what size it is, and how it would fit you, will you be able to make a buying decision based on how the shopkeeper described it?</p><p>Though you cannot try the T-shirt on you, how about taking a look at it yourself? How about taking a peek into its designs and touch and feel the quality of the material?<br> Even e-commerce sites have some sample images, descriptions, specifications, and reviews from previous buyers to convince you.</p><p><em>I hope, you got my point here.</em></p><p>A resume is a tool to showcase your skills, valuable experiences, and academic background. It will make the potential employer take a justified hiring decision based on the provided information to understand how your individual contribution or leadership skills can contribute to the organization’s success. Having a strong resume is what will set you apart from the competition.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*uhOercddfDi0lVBj2JMW3w.jpeg" /><figcaption>Photo by <a href="https://unsplash.com/@markuswinkler?utm_source=unsplash&amp;utm_medium=referral&amp;utm_content=creditCopyText">Markus Winkler</a> on <a href="https://unsplash.com/s/photos/resume?utm_source=unsplash&amp;utm_medium=referral&amp;utm_content=creditCopyText">Unsplash</a></figcaption></figure><p>Let’s jump next to how it can be written in the right way.</p><p>There’s no <em>one-right-way</em> to build the resume.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/300/0*NE545cFjVeL8jDzP.gif" /></figure><p>The factors to consider before writing each section will let you decide what would be a suitable structure, what’s important to include, and what can be skipped on your resume.<br> With all the best practices considered, you will eventually get to the point of building the resume in the right way, for you.</p><p><strong>What are the factors that need to be considered?</strong></p><p><em>That depends.</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/320/0*yplwKbpu4uA-FGdq.gif" /></figure><p>That’s true. It completely depends on what information do you want to fill in your resume. You may or may not want to highlight specific information such as academic results in the irrelevant area, certifications, photograph of yourself, references, personal information, and so on.</p><p>But, let’s see if they should really be optional for a better resume.</p><p><em>Sounds easy, right?</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/480/0*BWEPEnc8aGK4t6U0.gif" /></figure><p>No, they may not necessarily be easy to make those decisions. Target geography, type of industry, the culture of the targeting company, and a few other factors need to be considered before adding or removing some information and structuring it.</p><p><strong>Are the ways resume built, same across different countries?</strong></p><p>It is definitely not the same way. But, some structures are followed the same way in many countries.</p><p>For example, including the photograph is a matter of choice in South-East Asia and some other Asian countries like India, Pakistan, Sri Lanka, and Bangladesh.<br> But, it is recommended to include it in the resume and most of the employers expect it from the candidates’ resume in Europe. Also, it is preferred to use CV over a resume for some European countries.</p><p>It is recommended to avoid photographs in the US as it may lead to bias based on racial preferences.</p><p>So, the deep analysis of the geography has to be done before building your resume depending on your target country or region to avoid any biases and follow their cultural practices to attract the employer by showcasing your fit for the position.</p><p><strong>Are the ways resume built, same for every industry?</strong></p><p>You know the answer, of course, it is <em>not</em> the same standard across different industries.</p><p>Some sections might be relevant for a particular industry and may not be relevant for the other, which is the reason why there’s a variety in the resume standards.</p><p>For example, in the case of the Software Engineer resume, you may include information on certifications on some technologies, participation in hackathons, most challenging software designs, open-source contribution, and some big failures. If you may take up a Sales professional career, you may highlight some of the deals closed, challenging prospects, winning over a big competitor, and some numbers like recurring revenue, total revenue, and lifetime value of the customers from the deals you have closed.</p><p>The abstraction is the same even though the details might vary.</p><p>So, let’s jump into the point.</p><p><strong>What information to add in your resume regardless of geography and industry?</strong> <strong>Personal details</strong></p><ul><li>Fullname, email id, phone number should be added to notify the best way to contact you.</li><li>Gender — It can be added if you wish. Anyway, it can most-probably be guessed from your full name.</li><li>Age and Marital status — Again, it is your preference. It will help recruiters best guess the fit for the job if added.</li><li>Sexual orientation — Need not to mention unless the target company has diversity policies that may add benefit to you and you think it is safe.</li><li>Address — Your local address can be added. In case of the absence of a local address, the permanent address can be added. Never forget to add province/state and country along with the addresses.</li><li>Nationality — It is must-needed information if case you’re in a foreign country or the target country is different.</li></ul><p><strong>Objective or Summary</strong></p><ul><li>Ideal resume should have it.</li><li>This should answer what are you looking for, from your new job.</li></ul><p><strong>Skills</strong></p><ul><li>It may be your technical or non-technical skills depending on your industry.</li><li>Only highlight the skills that wish to continue work on.</li></ul><p><strong>Experience</strong></p><ul><li>It should be in reverse-chronological order. Keep it super-short. This should have the appropriate skills used and learned for the relevant job.</li><li>The description should have outcomes (mostly, in numbers) instead of the objectives and responsibilities.</li></ul><p><strong>Academics</strong></p><ul><li>It should be in reverse-chronological order, as well.</li><li>Prefer mentioning only the relevant studies or major educational milestones. For example, Ph.D., post-graduate, under-graduate, and other studies that are equivalent to a degree can be added here.</li></ul><p><strong>Social and professional handles</strong></p><ul><li>Social network profiles and listing can be added to showcase your personal branding if they are career-oriented or professional.</li></ul><p><strong>Certification</strong></p><ul><li>Add the major relevant certifications along with the motivation of you to do the same.</li><li>If they have a verifiable link, provide them as well.</li></ul><p><strong>Projects</strong></p><ul><li>Add the projects that you have done which are not part of your work. It can be a side-hustle, passion project, and even a hackathon project.</li><li>Even add the projects that you’ve worked in a minor part with the highlight of your work on it.</li></ul><p><strong>Hobbies</strong></p><ul><li>It might be so intimidating to add your entertainment category of hobbies here. But, say a strict NO for them.</li><li>Remember to add only the relevant hobbies for the role that you apply. For example, blogging would be a relevant hobby for technical writer role and marketing roles, competitive coding for software engineers, and reading books would be a fit for any roles. 📚 ❤️</li></ul><p><strong>Designs</strong></p><p>Prefer designing the resume if you can. A plain resume would also be fine if they are crisp and clear.</p><ul><li>Styles — Use bold and italic styles wherever appropriate. But, do not overdo it.</li><li>Fonts — Do not introduce more than two font families.</li><li>Colors — It sometimes depends on the company and its culture and interests on the casual to the professional level.<br> There are some color themes are preferred in the market such as,</li></ul><ol><li>Mono-color: One color shade with different hues used.</li></ol><p>2. Triadic: Three different colors in the color wheel with equal distance chosen to attract eyes. This may stand out when compared with other resumes because it may look crazy. So, it is not recommended for a traditional professional role.</p><p>3. Complementary color palettes: Using two opposite colors in the color wheel throughout the resume.</p><p>Whatever you choose, make sure the end resume still looks professional. Send the resume as PDFs to make sure all your efforts on the looks were the same when the recruiters see.</p><p><strong>What can be preferred to skip?</strong> <strong>More pages</strong></p><ul><li>Typically one page is enough unless you have more than 7 years of experience. In that case, two pages maximum. Be mindful that recruiters spend an average of 7.4 seconds looking at your resume.</li><li>Do not clutter the details. Exceptionally, you can extend the pages if needed.</li></ul><p><strong>Paragraphs</strong></p><ul><li>Do not use paragraphs. Always use bullet points that will help skim through the details quickly.</li></ul><p><strong>Photograph</strong></p><ul><li>It is not needed most of the time. You can add if you wish and think it will give more confidence to you and the recruiter for some profession.</li><li>Beware that you might be judged with it in some regions in Asia and the United States, it may even go up to lower priority in opportunity and rejections.</li></ul><p><strong>Repetitive words</strong></p><ul><li>Unconsciously you might have over-used some words repeatedly.</li><li>Try to be clever to find new synonyms and enrich your phrases with similar words but not the same.</li></ul><p><strong>Date</strong></p><ul><li>Just month and year will do. Do not attach date in any details such as date-of-birth, education, experience, certification, courses, and so on.</li></ul><p><strong>Irrelevant hobbies</strong></p><ul><li>Some irrelevant hobbies would even backfire for you. So, do not include entertainment and lazy activities and other irrelevant hobbies.</li></ul><p><strong>Grammatical mistakes</strong></p><ul><li>It might sound funny. I have found grammatical mistakes and typos in some of my friends’ resumes and candidates applied for interviews.</li><li>Use grammatical checker tools like <a href="https://www.grammarly.com/">Grammarly</a>.</li></ul><p>So far, we have seen how the resume can be written in the right way by considering the factors listed above.<br> Let’s see what are the other ways to showcase your profile to the employer rather than writing a resume which has these many struggles.</p><p><strong>Other ways to showcase skills and experiences:</strong></p><p><strong>Portfolio sites</strong><br> This is famous across many industries from software engineering and bloggers to fashion and photography.</p><ul><li>You can alternatively go with a portfolio site that will showcase all the above details with some interactive page rather than a two-page static content. It can also be attached along with the resume.</li><li>It has some advantage of making it an awesome experience from creative designs to cool way of interactivity on the webpage.</li><li>This can have many pages and a list of portfolio highlights without boring the recruiter.</li><li>It can be maintained with real-time updated data to see, though applied for jobs a few days or weeks before.</li></ul><p><strong>Professional and social networks</strong></p><ul><li>You can build and maintain some of your professional and social profiles and use them to highlight your works and activities.</li><li>LinkedIn, Medium, GitHub, Pinterest, Dribble, and Product Hunt are some of the social profiles used as resumes.</li><li>Sometimes, this may not be strong enough to send to the recruiters without a resume.</li><li>A resume or a cover letter or both can be attached together to go as a perfect profile showcase kit.</li></ul><p><strong>Some of the samples of resumes</strong></p><ol><li>Mine — <a href="http://ravirajsubramanian.github.io/">ravirajsubramanian.github.io</a><br>I have not used this for any career change, so it was experimental when I built and may not be updated now. I wish to keep it updated always and it gets postponed due to some of my side-project that I never complete. 😝</li><li>Emma Bostian — <a href="https://emmawedekind.com/resume-templates">https://emmawedekind.com/resume-templates</a> and <a href="https://twitter.com/emmabostian/status/1235154752700375041">https://twitter.com/emmabostian/status/1235154752700375041</a></li></ol><p><strong>Sample portfolio sites</strong></p><ul><li><a href="https://iamsaravieira.com/">https://iamsaravieira.com</a> — Programming</li><li><a href="https://www.dimeloper.com/">https://www.dimeloper.com</a> — Programming</li><li><a href="https://sarah.dev/">https://sarah.dev</a> — Developer Experience</li><li><a href="https://www.alispit.tel/">https://www.alispit.tel</a> — Programming teacher</li><li><a href="http://nareshnilphotography.com/">http://nareshnilphotography.com</a> — Photography</li><li><a href="https://www.ijustine.com/">https://www.ijustine.com</a> — YouTuber</li></ul><p><em>Originally published at </em><a href="https://dev.to/ravirajthedeveloper/build-a-resume-in-the-right-way-3emp"><em>https://dev.to</em></a><em> on May 10, 2020.</em></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=cd5f506172d4" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>