platform

Links:

• 💬 Chat
  • Forum for issues/questions
  • My homepage for contact info
• 🪄 Cheatsheet
• 📒 Notes
• 🚨 Release

Table of contents:

• ➗ Code
• 🎁 Contribute
• 🚢 Development life cycle
• 📄 Documentation
• 🛸 Mission

Overview

TODO
what to find where

➗ Code

For the complete setup, see latest release documentation, then go to Playbooks / Setup dev environment. If you just want take a look at the code, clone the repository using fossil:

fossil clone https://dev.rswk.ch/fossil/platform

Guidelines

• Always place semicolons
• Always use brackets for control flow statements
• Comments are a last resort. Put effort into expressive code and names. Comments lie!
• Everything is in ASCII order
• No dangling commas
• No negation ! ➖ expression == false
• No preincrement/postincrement operators i++ ➖ i = i + 1
• Only use </<= ➖ 0 < limit && limit <= 10
• Practice continuous integration/trunk based development
• Queues don't fix overload
• Sometimes boring is better
• Use IntelliJ formatters
• Version numbers are the TL;DR of release notes

Principles

• Principles behind the Agile Manifesto
• The only way to go fast, is to go well. — Robert C. Martin
• There are no solutions. There are only trade-offs. — Thomas Sowell

Quirks

• FwException is a RuntimeException [1]
• Unified test module instead of src/main/test per module

🎁 Contribute

TODO fossil patches, no AI generated/assisted code

🚢 Development life cycle

TODO
framework deploy
two phases: versioned and released modules in platform/deploy. customized and installable modules in platform-deployable
tools: watchdog, jenkins, nexus. CI, CD, trunk based
playbooks, runbooks
operations

📄 Documentation

• Release
  • 3.0.0
• Snapshot
• Legacy
  • 2.33.1

🛸 Mission

Provide an open source platform to develop, deploy and operate business applications as a solo developer professionally, quickly and to high standards.

• Built on open source and licensed as F/LOSS
• Covers the full development life cycle
• Full-featured framework
• Own your tech stack. Minimal abstractions, dependencies and lockin. Self-contained, self-hosted