Latest Updates

Documenting code, one commit at a time.

JavaScript Python

Streamlining Content Generation with LinkedIn Prompts in Devlog-ist/landing

This post details the recent enhancements to the content generation process within the devlog-ist/landing project, focusing on the integration and management of LinkedIn prompts for improved content quality and platform-specific tailoring.

The Goal

The primary objective was to enhance the content generation workflow by incorporating LinkedIn-specific prompts, allowing for more targeted and

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 AI Auditability Through Structured Summaries

Improving the auditability of AI interactions is crucial for maintaining security and control. A recent update focuses on preventing the exposure of raw code to AI models, enhancing data security, and providing better insights into flagged code changes.

The Challenge of Raw Diffs

Previously, raw git diffs were sent to AI models for analysis. This approach, while providing detailed context,

Read more
Python JavaScript

Adding a Safe Mode and Improving Code Generation

This post discusses recent improvements to our application, focusing on enhanced security measures and smarter code generation capabilities.

Safe Mode Implementation

We've introduced a 'safe mode' feature, giving tenants more control over security audits during post generation. By default, safe mode is enabled, ensuring all generated content undergoes a thorough security check.

Read more

Enhancing AI Auditability: From Raw Diffs to Structured Summaries

Improving the way we audit code changes is crucial for maintaining security and stability in our applications. Recently, we transitioned from feeding raw Git diffs directly to our AI analysis tools to using structured summaries. This shift significantly enhances auditability and reduces the risk of exposing sensitive information.

The Problem with Raw Diffs

Sending raw diffs to AI models

Read more
Python

Mitigating False Positives in Security Audits for Code Examples

Introduction

Security audits are crucial for maintaining the integrity of applications. However, overly sensitive rules can lead to false positives, particularly when dealing with illustrative code examples. This post discusses how to refine audit rules to distinguish between genuine security vulnerabilities and intentionally simplified or educational code snippets.

The Challenge:

Read more
Python JavaScript

Handling Audit False Positives with Domain Validation

Introduction

Auditing tools are crucial for maintaining application security and compliance. However, false positives can create unnecessary noise and divert attention from genuine threats. One common source of these false positives is the detection of reserved domain names, such as those under the IANA's example.com, example.net, and example.

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