Skip to content

Add CONTRIBUTING.md#122

Merged
khush-bhatia merged 1 commit into
apache:mainfrom
jbonofre:contributing
May 22, 2026
Merged

Add CONTRIBUTING.md#122
khush-bhatia merged 1 commit into
apache:mainfrom
jbonofre:contributing

Conversation

@jbonofre

Copy link
Copy Markdown
Member

This PR extracts content from docs/index.md to focus on contributions. The purpose is to describe how to contribute on the project, with the Apache Way.

@jbonofre
jbonofre requested review from jklahr and khush-bhatia May 12, 2026 16:26
Comment thread CONTRIBUTING.md
1. **Read the Specification**: Familiarize yourself with the [core specification](core-spec/spec.md) to understand the semantic model format.
2. **Explore the Examples**: Review the [TPC-DS example](examples/tpcds_semantic_model.yaml) to see a complete semantic model in practice.
3. **Join the Conversation**: Open or participate in [GitHub Issues](https://github.com/open-semantic-interchange) and Discussions to share ideas and feedback.
4. **Submit a Pull Request**: Fork the repository, make your changes, and submit a pull request. All contributions go through the standard review process described below.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we add link to the roadmap.md here ?
https://github.com/open-semantic-interchange/OSI/blob/main/ROADMAP.md

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's a good idea. Let me add it.

jklahr pushed a commit to jklahr/jklahr-ossie that referenced this pull request May 18, 2026
Add Ontology & Semantic Interoperability as a top-level current effort
with links to discussions apache#22, apache#101, apache#108, apache#68 and PRs apache#124, apache#125.

Update existing sections with recently opened discussions, PRs, and
converters: metric trees (apache#40), primary key semantics (apache#15, apache#119),
reusable datasets (apache#103, apache#109), datatype/is_time reframe (PR apache#113),
spatial dimension types (apache#114), default_aggregation (apache#115), positive
direction (apache#41), physical metadata (apache#110), and new converter PRs for
Salesforce (apache#118), dbt (apache#116), and Databricks (apache#120). Also adds
CONTRIBUTING.md (apache#122) and working groups page (apache#123) to Developer
Experience, and lists merged converters as existing artifacts.

Made-with: Cursor
jklahr pushed a commit that referenced this pull request May 19, 2026
Add Ontology & Semantic Interoperability as a top-level current effort
with links to discussions #22, #101, #108, #68 and PRs #124, #125.

Update existing sections with recently opened discussions, PRs, and
converters: metric trees (#40), primary key semantics (#15, #119),
reusable datasets (#103, #109), datatype/is_time reframe (PR #113),
spatial dimension types (#114), default_aggregation (#115), positive
direction (#41), physical metadata (#110), and new converter PRs for
Salesforce (#118), dbt (#116), and Databricks (#120). Also adds
CONTRIBUTING.md (#122) and working groups page (#123) to Developer
Experience, and lists merged converters as existing artifacts.

Made-with: Cursor

@QMalcolm QMalcolm left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me! Thank you for putting this together @jbonofre

Comment thread CONTRIBUTING.md
2. **Explore the Examples**: Review the [TPC-DS example](examples/tpcds_semantic_model.yaml) to see a complete semantic model in practice.
3. **Join the Conversation**: Open or participate in [GitHub Issues](https://github.com/open-semantic-interchange) and Discussions to share ideas and feedback.
4. **Submit a Pull Request**: Fork the repository, make your changes, and submit a pull request. All contributions go through the standard review process described below.
5. **Join the Slack workspace**: Chat directly with the community by [joining Slack](https://join.slack.com/t/opensemanticx/shared_invite/zt-3pq1j0lid-tQBbEvAngAvz0I0vZm~HJw).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just of note, we may need to periodically update this, no action to take.

I think slack invite links without a time expiration have a max invite count of 400 instead. Hopefully slack notifies us when that is hit, at which time we'll have to update this to a new link.

@khush-bhatia

Copy link
Copy Markdown
Contributor

@jbonofre Merging this as a few people are asking for it. We can do the roadmap update in a follow up.

@khush-bhatia
khush-bhatia merged commit 09d375e into apache:main May 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants