Photon Central Database
Welcome to the central knowledge repository for the Photon programming language.
📂 Database Main Index
🖖 Deck 1: Language Protocols
Target Audience: Users, Cadets, and Language Designers. Essential reading for those deploying Photon in the field.
- Core Manual: The primary entry point for learning Photon.
- Prime Directives: The philosophy and design constraints governing the language.
- Syntax Specifications: Detailed grammar rules and structure.
- Field Examples: Reference implementations and usage patterns.
- Code Organization: Protocols for structuring standard Photon projects.
- Metaprogramming: Advanced compile-time manipulation capabilities.
🔧 Deck 2: Engineering & Internals
Target Audience: Compiler Engineers and Contributors. Restricted technical specifications for the “Phaser” compiler engine.
- Engineering Guide: The start point for compiler development.
- Core Architecture: The 5-phase compilation pipeline design.
- Source Structure: Layout of the compiler codebase (
compiler/directory). - AST Schematics: Abstract Syntax Tree definitions.
- Diagnostics: Testing protocols and validation suites.
📝 Contribution Protocols
Standard Issue Tool: Obsidian is the recommended interface for accessing and modifying the archives to ensure full compatibility with the knowledge graph.
When submitting updates to the archives:
- Language Design: Updates to the language specification reside in
docs/language/. - Engine Specs: Compiler implementation details reside in
docs/contributing/. - Linking: Maintain the knowledge graph using
[[WikiLinks]]. - Examples: Theoretical concepts must be accompanied by concrete examples.
📊 Mission Status
🚧 Status: Experimental / Pre-Warp Photon is currently in active research and development.
Current Objectives:
- Finalizing Language Specifications.
- Constructing the Phaser Compiler Infrastructure.
- Establishing comprehensive training simulations (Tests & Examples).