{"id":14155918,"url":"https://github.com/speced/bikeshed-boilerplate","last_synced_at":"2025-04-25T12:32:03.204Z","repository":{"id":37809146,"uuid":"407267342","full_name":"speced/bikeshed-boilerplate","owner":"speced","description":"Boilerplate files for Bikeshed specs","archived":false,"fork":false,"pushed_at":"2025-04-02T18:10:44.000Z","size":746,"stargazers_count":10,"open_issues_count":4,"forks_count":38,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-04-23T00:48:31.313Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/speced.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-09-16T18:07:03.000Z","updated_at":"2025-04-02T18:10:47.000Z","dependencies_parsed_at":"2023-09-27T13:11:14.194Z","dependency_job_id":"09071a1a-685a-4233-9507-97b0201b0a93","html_url":"https://github.com/speced/bikeshed-boilerplate","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/speced%2Fbikeshed-boilerplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/speced%2Fbikeshed-boilerplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/speced%2Fbikeshed-boilerplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/speced%2Fbikeshed-boilerplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/speced","download_url":"https://codeload.github.com/speced/bikeshed-boilerplate/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250817841,"owners_count":21492237,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-17T08:05:05.579Z","updated_at":"2025-04-25T12:32:02.099Z","avatar_url":"https://github.com/speced.png","language":"Python","funding_links":[],"categories":["others"],"sub_categories":[],"readme":"# Bikeshed Boilerplate\n\nThis repo holds the boilerplate files (header, footer, other \"constant\" bits of specs) used by [Bikeshed](https://github.com/tabatkins/bikeshed).\n\nThe top-level files in the `boilerplate/` folder are used by default,\nif there's nothing more specific.\n\nThe subfolders are for specific groups (the `Group` metadata in a Bikeshed file) to override the defaults with group-specific variants. In there, the filename may also have a status (the `Status` metadata in the Bikeshed file) to further specialize them.\n\n## Altering Boilerplates\n\nIf you need to change an existing boilerplate for your group,\njust send a PR.\n\n## Adding or Removing Boilerplates\n\nIf you need to add or remove files from an existing group's folder,\nsend a PR.\nAbout a minute after it's merged,\nan automated \"update the manifest\" PR will show up\nand needs to be merged as well.\n\nIf you're adding files for a new group,\nlook for an existing group's files that generate specs that look similar to what you want.\nIf you're a W3C group, start with the contents of the `boilerplates/w3c/` folder.\nThen update the `boilerplate/doctypes.kdl` file to document the new group.\n\n## Testing Boilerplates Before Adding Them Here\n\nIf you want to verify that your new or updated boilerplates work the way you want before you PR this repo,\njust put the boilerplates in question into the same folder as your spec file.\nBikeshed looks for boilerplates in the spec's folder first,\nbefore it starts searching thru its own data files.\n\n(If you're using the API version of Bikeshed, or passing Bikeshed a spec on stdin,\nthere's no way to test new boilerplates.\nInstall it locally from `pipx` and put the spec into a file.)\n\n## When Are Boilerplates Available?\n\nAfter a boilerplate change has been merged,\na PR will be automatically created with the appropriate changes to the manifest file.\n(This can be done manually by running `./update-manifest` in this folder).\n\nOnce that PR is merged, a few minutes later the change will be picked up by [bikeshed-data](https://github.com/tabatkins/bikeshed-data)\n(check the commit log to see it),\nat which point a `bikeshed update` will bring the new boilerplates in.\nAlternately, manually updating the boilerplates with `bikeshed update --skip-manifest --boilerplate` will pull the new files down immediately,\nwithout waiting for `bikeshed-data` to update.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspeced%2Fbikeshed-boilerplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspeced%2Fbikeshed-boilerplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspeced%2Fbikeshed-boilerplate/lists"}