Software Dev

[!todo] Reorg this note

Foundational Rules and Principles

• IMPORTANT: ALWAYS follow Naming Systems, especially for Coding.
• Focus on coding with world-class professional standards, for …
  • clarity (readable)
  • maintainability
  • robustness, …
• Produce results as efficiently as possible, with …
  • careful planning
  • using (the best) AI tools as much as possible
  • using Templates
• Error Management
  • Monitor and log errors to a .log file
  • Notify developer of errors via email; SMS and modal popup for critical issues.
  • Use tools like Sentry (or better)
• Type Safety
  • use Type Hints for Python Utilities (for all but the simplest projects)
  • use Typescript for web dev projects (for all but the simplest issues)

Project Types

All software development is in one of these categories.

• System Utilities
• Side Projects, for learning
• Production Apps, for business products

Tech Stack and Guidelines

Python

• TODO: integrate Programming Guidelines from Notes.eco

• use package manager UV instead of pip for Python package management

Javascript/Typescript

• use pnpm as package manager for Node.js, instead of npm

Astro

• use for all websites, defaulting to static SSG

Svelte

• use for all components, including in Astro sites