Contributing to SAMM

Interested in contributing to SAMM?

Here’s how you can do it!
Link icons indicate links to pages on our website where you can find the information.

• Users and practitioners

• Benchmark
  How am I doing? What works for similar organizations? Donate SAMM data sets!
  Visit our benchmark page.

• GitHub issues
  Read more about how we use GitHub for our content and how you can contribute.

• Translations

• Sponsorship
  Visit our sponsors page to learn more about the process, what happens with the proceeds, and what the benefits are.

• Feedback

Users and practitioners

We have created a Users page to share organizations that have adopted SAMM and a Practitioners page to list companies providing SAMM services.

Contact us if you want to be listed so we can all get an idea of who is using SAMM and how that’s working for them.

GitHub issues

All of SAMM’s content is on Github .

We use

• YAML files for the data that makes up the model - core repository
• Hugo for the website - website repository

Familiar with GitHub?

To make changes to either, follow these steps:

1. Create a branch from one of our repositories
2. Make changes and push the branch to GitHub
3. Create a pull request and add someone in the SAMM core team as a reviewer

Once the changes are approved, someone from the team will merge that branch to the main branch of the corresponding repository.

Not familiar with GitHub?

GitHub is a company that provides hosting for software development version control using Git.
If you’ve never used Git or GitHub you can always use the regular channels for feedback.

Read our blog post on how SAMM is doing CI/CD.

What is Hugo?

Hugo is a static site generator written in Go, a statically typed, compiled programming language. It integrates well with GitHub and allows us to automatically build the site every time we make changes.

Translations

We’ve started using Crowdin for localization management. We want to have the SAMM model available in as many languages as possible.
Visit our project page on Crowdin to start contributing.

Feedback

SAMM is a community-driven project. We welcome all feedback and input. You can use the contact form link from the main menu or any of the options available from the footer of the website.

If you want to join our Slack channel but the direct link doesn’t work, you need invitation. Get it here .