Latest Updates

Documenting code, one commit at a time.

Node.js JavaScript

Improving LinkedIn Publish Performance by Caching Images Server-Side

The devlog-ist/landing project focuses on creating landing pages. Recently, we tackled a performance bottleneck during the LinkedIn publishing process. The issue arose from sending large base64 encoded images directly within the publish request, leading to 413 errors from Nginx due to exceeding the maximum request size.

The Problem

LinkedIn's API has limits on request size. Sending a

Read more
JavaScript Node.js

Independent Control for LinkedIn Post Generation

When developing tools for content generation, flexibility is key. A recent update to the devlog-ist/landing project focuses on providing more granular control over how content is generated for different platforms. Specifically, we've decoupled the random mode setting for LinkedIn from the portfolio's random mode.

The Problem: One Size Doesn't Fit All

Previously, a single "random mode"

Read more
JavaScript Mermaid

Handling Mermaid Diagram Rendering Errors

Sometimes, the most challenging bugs are not in the core logic, but in the tooling around it. Recently, while working on the diagram rendering service for a project, I encountered an issue where invalid Mermaid syntax would cause the entire process to hang. Here's how I tackled it.

The Problem

The diagram rendering service, used for generating visualizations, relied on an external script to

Read more
PHP Mermaid

Improving Code Quality with Consistent Mermaid Diagram Generation

Introduction

Ensuring consistent code quality and documentation can be a challenge. One area where consistency is crucial is in the generation of diagrams for technical documentation. This post discusses how we've improved the consistency and validity of Mermaid diagrams generated as part of our technical writing process for the devlog-ist/landing project, which provides a landing page for

Read more

Enhancing Workflow Reliability with Code Review

In software development, a robust workflow is crucial for maintaining code quality and minimizing potential issues. Recently, we've focused on refining our development process to incorporate more rigorous code review practices, specifically before finalizing changes.

The Importance of Early Code Review

Integrating a 'dev:code-review' step earlier in the workflow offers several key advantages:

Read more

Unifying Generation Workflows for Enhanced Security and Reliability

This post details how we streamlined our content generation process to improve security, consistency, and maintainability.

The Challenge

Previously, our application used separate code paths for generating content based on user prompts versus automatic generation. This divergence led to inconsistencies in security auditing, resource management, and error handling.

Read more

Enhancements to Referral Program, Dev.to Integration, and Terms Update

Overview

This update introduces an enhanced referral program with tiered commissions, seamless Dev.to integration, and updated terms and conditions to reflect these changes.

Referral Program Enhancements

The referral program has been expanded with the addition of a dedicated landing page, complete with details about the program, commission rates, and automated tools.

Read more

Fixing Placeholders in Our Application

Sometimes, during development, placeholder values can inadvertently slip into the final application. This post discusses how we addressed such an issue in our vlog index page, specifically focusing on unresolved :app_name placeholders.

The Problem: Unresolved Placeholders

Unresolved placeholders are problematic because they present a poor user experience and can sometimes expose internal

Read more

The Hidden Cost of Unused Placeholder Fixes

We've all been there: a quick fix for an apparent issue, like an unresolved placeholder in a user-facing section. But what happens when the fix itself introduces more complexity than it resolves?

Recently, we addressed an issue where the :app_name placeholder wasn't being correctly rendered on the /earn hero section of our application.

Read more