Skip to content

Latest commit

 

History

History
52 lines (36 loc) · 1.96 KB

README.md

File metadata and controls

52 lines (36 loc) · 1.96 KB
Raw

Ruby Toolbox Catalog CI

Welcome to the Ruby Toolbox catalog!

This repository contains the mapping of category groups, categories and ruby open source projects and is based on a database dump of the old Ruby Toolbox site.

You can find the current exported catalog at https://rubytoolbox.github.io/catalog

Contributing

Help wanted! Feel free to send pull requests against this repo to add or moderate existing categories.

If you plan on bigger changes, please consider:

  • splitting your changes into multiple separate PRs to avoid merge conflicts
  • if your changes could need discussion, please create an issue on the main repo up-front for further discussion.

Structure

You can find the catalog in catalog. The structure is validated at build time against the JSON schema.

The folder structure is as follows:

catalog/
  CATEGORY_GROUP_1_PERMALINK/
    _meta.yml # Allows to add metadata about category group
    category_1_permalink.yml # Definition of category and its projects
    ...
  ...

Each category group contains a _meta.yml, which currently only defines the name key, which should be the human display name of that category.

Each category.yml currently contains:

  • name (string, required): Human display name of the category name
  • description (string, optional): A (markdown-formatted) category description
  • projects (array of strings in case-insensitive alphabetical order, required): The list of projects to list in that category. For rubygems, this is the plain gem name, for github repos it's the full repo slug (github_user/repo_name). Projects can be listed in multiple categories.