This repo is powering the InnerSource Commons Website at innersourcecommons.org.

The site is built with Hugo framework. All content is located at the content folder.

It can be done easily via editing the content in this repository. Just make changes through GitHub UI or clone the repository to your computer and push to remote. Create a Pull Request and after the review changes will be automatically uploaded to the site.

If you are adding any widgets to the site, please check if they add cookies by clicking the lock in front of the URL in your browser and checking the cookies before and after you add the widget.

In case the widget adds cookies to the website please update the Privacy Policy (content/about/privacy.md) with the new cookies.

GitHub Codespaces provides an easy way to work on the website without installing anything on your local machine:

1. Navigate to the repository on GitHub
2. Click the green "Code" button
3. Select the "Codespaces" tab
4. Click "Create codespace on master"
5. Wait for the codespace to load (this may take a minute)
6. Once loaded, click the "Run and Debug" icon in the sidebar (or press F5)
7. Select "Hugo Server" from the dropdown menu and click the play button
8. When prompted, click "Open in Browser" to view the website

The website will be displayed in a new browser tab, and any changes you make will automatically update in real-time.

For a more detailed guide with screenshots, please see our Codespaces documentation.

If you want to test the page before commit you can run the site locally. you need to have git and hugo installed. Please follow the official installation instructions.

git clone [url]
cd innersourcecommons.org
hugo server

Alternatively, if you have Docker installed in your machine, you can do the same with docker compose, as shown below.

git clone [url]
cd innersourcecommons.org
docker compose up -d

Using GitHub Codespaces, you can see and interact with the version of the site that is in pull request. Check out this video to see how.

You can add your own organization to the Stories Page, to showcase that you are practicing InnerSource. Note: You can even do that for other organizations, given that you can point to public evidence of that org talking about their InnerSource approach.

To add a new logo/org to the Stories page, please fill in this issue and follow the instructions in there.

To increase familiarity with the InnerSource concept among non-English speakers, the ISC website provides pages in multiple languages. These translations are completed by volunteer contributors and are not immediately available for all pages. As a result, there may be a significant amount of content that is currently in the process of being translated. We welcome any contributions to the translation effort!

Instructions can be found here.