Skip to content

adaptdk/contrib

Repository files navigation

Open Source Contributions Log

This project tries to gather information about open source contributions for a given organization.

Producing output files

First, make sure you installed dependencies, e.g. composer install.

HTML

There is some scripting in place to generate an HTML page based on the data. It also contains JSON-LD output that may be useful if the page is public at some point.

You may want to try the following command.

./contriblog html > contributions.html

RSS

There is also a way to produce RSS output.

You may want to try the following command.

./contriblog rss > rss.xml

Adding entries

  • Use the helper, e.g. ./contriblog add, or
  • Manually edit the YAML file, and process it with ./contriblog format to get it on the standard output.

YAML format

The YAML file tries to be self-explanatory. It tries to describe contributions thinking in possible future use of the data.

Types are CHAOSS Types of Contributions.

Contributions are sorted by date.

You may want to enable the git pre-commit hook, e.g. with git config core.hooksPath .githooks.

References

Credit

This project has been initially developed by Adapt.