Skip to content

Latest commit

 

History

History
77 lines (74 loc) · 4.5 KB

index.md

File metadata and controls

77 lines (74 loc) · 4.5 KB
Raw
layout hero
home
name tagline actions
IxDF Open Handbook
Open handbook for developers (Laravel+JS) created by the IxDF tech team.
theme text link
ghost
Start here
/README.md
theme text link
ghost
Backend dev docs
/library/backend/README.md
theme text link
ghost
Frontend dev docs
/library/frontend/README.md

IxDF Zen Code

Development

  • We care deeply about "long-term code quality".
  • We do it "incrementally"; first do it, then do it right, then do it better.
  • We follow the boy scout principle; "Always leave the campground cleaner than you found it.".
  • We believe in the broken window theory; that's why we fix anything that's broken, as soon as we see it.
  • We use a "language of commitment": Say "yes" only if we (can/will) do it.
  • We tell others about potential problems as soon as possible.
  • We favor "explicit", "simple", "automated", "tested", and "flat".
  • We have "one" (and preferably "only one") way of doing things.
  • We make it "easy" to do "follow" our conventions and "difficult" otherwise.
  • We code in a way that doesn't require documentation or explanation.

Team

  • We celebrate our achievements and encourage everyone to contribute.
  • We all have decision-making authority, and everyone in the team is committed to each other's success.
  • We have a flat hierarchy; everyone does everything possible to never fail one another.
  • We don't punish anyone for making mistakes.
  • We care about communication; we believe the "how" in communication is as important as the "what".

Productivity

  • We believe motivation and productivity come naturally when you work on something you're passionate about.
  • We are action-oriented and strong believers in the maxim "ideas are worthless without execution."
  • We have enormous degrees of freedom because we are able to live up to that responsibility.
  • We finish what we have started; we don't feel good until we've carved a unicorn out of the monster.
  • We are "subversives" to a certain point-we understand small acts of defiance can lead to better outcomes.
  • We know that even small tasks can give us emotional rewards when we know why we are doing them.
  • We set audacious but achievable goals by breaking them into small and concrete plans.
  • We welcome critique; we use our mistakes in a constructive way to become stronger.

Community

  • We exist, because our community exists.
  • Our codebase reflects the high expectations of our community.
  • We constantly reshape our platform and codebase based on our community's needs.
  • We believe our platform and community will make the world a better place.

Quick links: Coding conventions