Back to Commons

Contribute to Commons

Share your knowledge, tools, and resources with the UAE Open Finance ecosystem. Every contribution helps lower barriers and accelerate adoption.

What You Can Contribute

Insight

Original thinking and analysis written by you.

  • How Open Finance data supports underwriting
  • Regulatory interpretation and guidance
  • Commercial or inclusion framing
  • Implementation learnings
Format: Markdown article with optional diagrams

Reference

Curated external articles that advance understanding.

  • Substack articles on Open Banking
  • Medium posts on consent UX patterns
  • Academic or policy research
  • Industry analysis
Format: Link + your written context

Artifact

Reusable but non-executable assets.

  • TPP Terms & Conditions templates
  • Consent UX patterns and flows
  • Data schemas and models
  • Checklists and playbooks
Format: Files, gists, or repo folders

Utility

Executable or forkable code and tools.

  • Demo TPP applications
  • Consent flow SDKs
  • Revenue & cost forecasting tools
  • Sandbox automation scripts
Format: GitHub repos or starter kits

How to Submit

All contributions go through GitHub. This ensures transparency, version control, and community review.

1

Fork the Repository

Fork the community-website repository to your GitHub account.

2

Create Your Contribution

Add a new Markdown file in src/content/commons/ with the required frontmatter metadata and your content.

3

Open a Pull Request

Submit a PR with a clear description. Include why this contribution is valuable to the ecosystem.

4

Community Review

Maintainers will review for clarity, relevance, and compliance with guidelines. Minor edits may be suggested.

Contribution Template

Each contribution requires frontmatter metadata. Here's the complete schema:

src/content/commons/your-contribution.md 
---
title: "Your Contribution Title"
type: insight | reference | artifact | utility
summary: "A 1-2 sentence summary of what this contribution provides."
date: 2024-01-15

# Required for references - explain the value
whyItMatters: "Why this external resource is valuable to the ecosystem."

# Taxonomy
useCases:
  - payments
  - underwriting
  - compliance
audience:
  - tpp
  - developer
maturity: concept | demo | production-ready
license: mit | apache-2.0 | cc-by-4.0 | proprietary | unlicensed

# Source (for external content)
source:
  platform: github | substack | medium | blog | research | other
  url: https://example.com/original-article

# Attribution
authoredByContributor: true  # false if curating external content
contributor: "Your Name or Organization"
contributorUrl: https://github.com/yourusername

# Links (include relevant ones)
links:
  github: https://github.com/org/repo
  demo: https://demo.example.com
  docs: https://docs.example.com
  article: https://external-article.com

# Governance
disclaimers:
  - "Example implementation only"
  - "Not legal or regulatory advice"
featured: false
---

## Your Content

Write your contribution content here using Markdown.

### Sections

Organize with clear headings.

- Use bullet points
- Include code examples if relevant
- Link to additional resources

Contribution Guidelines

Do

  • Provide clear, actionable content
  • Include proper attribution
  • Add disclaimers for legal content
  • Use permissive licenses for code
  • Write "Why It Matters" for references
  • Test code before submitting

Don't

  • Include confidential or proprietary data
  • Re-host full external articles
  • Submit vendor promotional content
  • Include real customer data
  • Use restrictive licenses without disclosure
  • Submit without testing

For External References

When curating external content, you're adding value through context and curation.

Always Required

  • Link to original source - never re-host content
  • "Why It Matters" field - your context on the value
  • Clear attribution - credit original authors
  • Source platform - indicate Substack, Medium, etc.

Your Added Value

  • Explain relevance to UAE Open Finance
  • Highlight key takeaways
  • Connect to other Commons resources
  • Suggest practical applications

Ready to Contribute?

Your knowledge and tools can help accelerate Open Finance adoption in the UAE. Every contribution compounds.

Fork Repository Ask a Question