Contributing to ModelSystem.One

September 19, 2026 · View on GitHub

Thank you for helping improve the public catalog of System One / Decision Models.

This repository (fabricioctelles/modelsystem) is the public contribution hub. The production website source is private. Use issues and pull requests here for:

  • Catalog proposals (new models)
  • Corrections (specs, pricing, status, links)
  • Content ideas for Learn / Guides / News
  • Site bug reports (public UX / broken links / SEO)

Before you open anything

  1. Read the catalog spec
  2. Search existing issues to avoid duplicates
  3. Prefer an issue first for large proposals; PRs are welcome for small doc/meta fixes in this repo

Open an issue

Use the templates:

  • Model submission — propose a System One model for the catalog
  • Correction — fix inaccurate data on the live site
  • Bug — broken page, link, locale, or accessibility issue
  • Content — Learn / Guides / News ideas

Or go straight to: https://github.com/fabricioctelles/modelsystem/issues/new/choose

Open a pull request

PRs should stay scoped to this repository (README, templates, CONTRIBUTING, samples).

  1. Fork the repo
  2. Create a branch: git checkout -b fix/short-description
  3. Make a focused change
  4. Open a PR with a clear summary and link related issues

We review manually. Expect a few days for a response.

Model submission checklist

Your issue should include:

  • Model name + company
  • Public docs / API URL
  • Status (ga | beta | waitlist)
  • Decision types supported (choice / score / boolean)
  • Latency / pricing if publicly documented
  • Why it meets the three inclusion criteria
  • Sources (vendor docs preferred over social posts)

Code of conduct

Be respectful. No harassment, spam, or vendor sock-puppet marketing without disclosure. See CODE_OF_CONDUCT.md.

Security

Do not file security reports for the private app in public issues. See SECURITY.md.

License

By contributing, you agree that your contributions are licensed under the MIT License (see LICENSE).