Skip to content

Contributing to Experience Notation

Thank you for your interest in contributing to Experience Notation!

Experience Notation is an open Domain-Specific Language (DSL) for modelling user journeys, personas, decisions, and contexts in a structured, human-readable format. It is actively maintained and developed as part of both open-source and applied projects like Demoscope.ai.

How You Can Help

We welcome contributions in the following areas:

  • Documentation improvements (typos, examples, clarity)
  • Example .expn journeys for new use cases
  • Discussions or feedback on syntax or structure
  • Use case sharing or reports from your own applications

At this time, we are not accepting major syntax changes without prior discussion.

How to Contribute

  1. Fork the repository
  2. Create a new branch Use descriptive names (e.g. fix-typo-validation-guide)
  3. Make your changes
  4. Submit a pull request (PR) with a clear summary of your contribution

Please keep your PRs focused and small. If you want to propose a larger change, start by opening a Discussion or Issue.

Repo Structure

Folder / File Purpose
spec/ EBNF, JSON Schema, and validation guides
examples/ Example .expn files
README.md Project overview and links

Coding and Style Notes

  • Use British English spelling in documentation
  • Follow the .expn formatting as defined by the EBNF grammar
  • Ensure .expn examples are syntactically valid and consistent
  • Document new examples with context and description if possible

License

By contributing, you agree that your contributions will be included under the Apache 2.0 License.

Support & Collaboration

Experience Notation is maintained by The Cato Bot Company Limited as part of the Context Notation initiative.

For questions about: - Using Experience Notation in your projects - Contributing to development - Research collaborations
- Commercial support options

Feel free to reach out:

📧 hello@context-notation.com
💬 GitHub Discussions
🌐 context-notation.com

💬 Questions or Ideas?

Open a GitHub Discussion — we’d love to hear from you.

Thanks again for helping improve Experience Notation!