Latest Updates

Documenting code, one commit at a time.

PHP JavaScript MySQL

Enhancing LinkedIn Banner Image Generation with Technology Badges

Introduction

This post explores how to enhance the automatic generation of LinkedIn banner images by including technology badges and a portfolio URL. This provides a richer, more informative visual representation for professional profiles.

Problem

Previously, the generated LinkedIn banner image only contained the person's name and position. This lacked context about their technical

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
Laravel PHP OAuth

Limiting OAuth Providers in Laravel

Working on the devlog-ist/landing project, we're refining the authentication flow. The goal is to streamline user registration and login, particularly for non-developers who might be contributing recommendations. We've adjusted the available OAuth providers to match user roles.

Previously, both GitHub and LinkedIn were presented as default options on the login and registration pages.

Read more
PHP Laravel OAuth

Enhancing User Security in Laravel OAuth Implementations

OAuth provides a streamlined approach to user authentication, but it's crucial to implement security measures that protect user data and prevent unauthorized access. A common scenario involves social login, where users authenticate via third-party providers like GitHub or LinkedIn.

The Problem: Unregistered Users and Automatic Registration

A potential vulnerability arises when users not yet

Read more

Enhancing Technology Detection in Post Generation

Improving the accuracy and scope of technology detection is crucial for generating relevant and informative content. A recent update introduces rule-based technology detection, significantly expanding our ability to identify the technologies involved in code changes. This enhancement allows for more precise tagging and categorization of blog posts, benefiting both content creators and readers.

Read more
PHP MySQL SQL

Enhancing Data Integrity and Performance in Reporting Queries

Introduction

Recent code reviews have highlighted several opportunities to improve the robustness, performance, and maintainability of our application's reporting queries. These changes focus on ensuring data consistency, optimizing query execution, and adhering to coding standards.

Addressing Potential Issues

Explicit Facade Imports

We addressed an issue where facades (like File

Read more
PHP MySQL SQL

Improving Database Performance and Code Quality: A Review Digest

Introduction

This post summarizes recent code review findings and improvements made to a database migration script within our application. The focus is on enhancing both performance and code quality through addressing issues ranging from index usage to data consistency and coding style.

Addressing Facade Imports

A critical issue identified was the absence of explicit facade imports.

Read more

Enhancing GitHub OAuth Flow: Preserving User Permissions

Introduction

This article discusses a common issue in applications using GitHub OAuth for authentication: inadvertently overwriting a user's existing token with one that has fewer permissions. We'll explore how to ensure the application preserves the user's original, broader-scoped token when requesting narrower scopes during subsequent logins.

The Problem

Many applications use GitHub

Read more