{"id":14975766,"url":"https://github.com/kubernetes/contributor-site","last_synced_at":"2025-05-16T15:08:27.386Z","repository":{"id":37542935,"uuid":"142935291","full_name":"kubernetes/contributor-site","owner":"kubernetes","description":"Code for kubernetes.dev","archived":false,"fork":false,"pushed_at":"2025-03-22T16:22:31.000Z","size":34236,"stargazers_count":72,"open_issues_count":15,"forks_count":156,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-12T14:17:10.394Z","etag":null,"topics":["k8s-sig-contribex"],"latest_commit_sha":null,"homepage":"https://www.kubernetes.dev","language":"HTML","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/kubernetes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"code-of-conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY_CONTACTS","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-07-30T22:41:38.000Z","updated_at":"2025-03-23T10:12:17.000Z","dependencies_parsed_at":"2023-10-12T10:42:24.979Z","dependency_job_id":"d2606051-68e1-4d70-9928-683f593a117e","html_url":"https://github.com/kubernetes/contributor-site","commit_stats":{"total_commits":575,"total_committers":120,"mean_commits":4.791666666666667,"dds":0.8765217391304347,"last_synced_commit":"617ea392f8571a5a027274c8b0ca4388f29abbff"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes%2Fcontributor-site","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes%2Fcontributor-site/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes%2Fcontributor-site/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes%2Fcontributor-site/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kubernetes","download_url":"https://codeload.github.com/kubernetes/contributor-site/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254553958,"owners_count":22090417,"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":["k8s-sig-contribex"],"created_at":"2024-09-24T13:52:31.024Z","updated_at":"2025-05-16T15:08:22.379Z","avatar_url":"https://github.com/kubernetes.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kubernetes Contributor Site\n\nThis repository contains the [Hugo][hugo] site and generator scripts for the\nKubernetes Contributor site. The published website is available at\nhttps://kubernetes.dev/ (served via Netlify).\n\n## Site content\n\nThe content for the Contributor Site is sourced from multiple locations.\nContent managed within this repository is generated from [Markdown]\nfound within the [`content`][ct] directory. To update the site's content,\nmake changes to the Markdown sources and [submit a pull request][pr] to this\nrepository.\n\nSome content is externally sourced and changes to that must be made in the\noriginal location. A list of sources and their locations within the\n[`content`][ct] is available below:\n\n### External sources\n\n- **Source:** https://git.k8s.io/community/contributors/guide \u003cbr\u003e\n  **Destination:** `/guide`\n- **Source:** https://github.com/cncf/foundation/blob/master/code-of-conduct.md \u003cbr\u003e\n  **Destination:** `/code-of-conduct.md`\n- **Source:** https://git.k8s.io/sig-release/releases/release-1.18/README.md \u003cbr\u003e\n  **Destination:** `/release.md`\n\n## Running the site locally\n\nTo develop site content, you can run the site locally using [Hugo][hugo] in\ntwo ways:\n\n1. [Inside a Docker container](#using-docker)\n2. [Natively](#natively) (not inside a Docker container)\n\nWhen you make changes to the site's content, Hugo will automatically update\nthe site and refresh your browser window.\n\n### Using Docker\n\nThe easiest and most cross-system-compatible way to run the Contributor\nSite is to use [Docker][docker]. To begin, create the docker image to be used\nwith generating the site by executing `make container-image`.\n\nTo ensure you can view the site with externally sourced content, run\n`make container-gen-content` before previewing the site by with\n`make container-server`.\n\n**NOTE to Apple Silicon Mac Users**\n\nBefore proceeding with the build steps, please ensure that you set the\n`DOCKER_DEFAULT_PLATFORM` environment variable to `linux/amd64` by using the \nfollowing command: \n\n```\nexport DOCKER_DEFAULT_PLATFORM=linux/amd64\n```\n\n### Natively\n\nFor instructions on installing and using Hugo, see the [Hugo Documentation][hugo-docs].\nNote that the extended version is required.\n\nIn addition to Hugo, the [postcss-cli] and [autoprefixer] JavaScript packages are\nrequired. These can be installed via the [Node Package Manager][npm] (`npm`) from a\nrecent version of [nodejs] with `npm install -g postcss-cli autoprefixer`.\n\nThe Contributor Site uses the [docsy] theme. It is included as a [git submodule].\nTo fetch docsy and its requirements, run the command:\n\n```\ngit submodule update --init --recursive --depth 1\n```\n\nTo ensure you can view the site with externally sourced content, run\n`make gen-content` before previewing the site by with `make server`.\n\n**NOTE to MacOS Users**\n\nThe `hack/gen-content.sh` script requires the gnu version\nof base packages such as `find`, `grep`, and `sed`. \n\n```\nbrew install coreutils findutils grep gnu-sed gnu-tar make readlink\n```\n\nYou will then need to update your path to include these:\n\n```\nexport PATH=\"/usr/local/opt/coreutils/libexec/gnubin:$PATH\"\n```\n\n## Community, discussion, contribution, and support\n\nThis project is managed by [SIG Contributor Experience][sig-contribex] as a\npart of [KEP-2225][kep-2225]\n\nYou can reach the maintainers of this project at:\n\n- [Slack][sig-contribex-slack]\n- [Mailing List][sig-contribex-list]\n\n## Evolution of this site:\n\nWe’re building out this site in real-time! Want to join us and help? Here’s what we have in store for next iterations:\n\n* [ ] Contributor guide/handbook: Feature launch date estimated January 2023\n* [ ] Developers' guide/handbook\n* [ ] Directory of Kubernetes SIGs and other community groups\n* [ ] Listing events beyond just Contributor Summits\n* [ ] Pathways to success for [new Kubernetes contributors](https://git.k8s.io/community/community-membership.md) and mentoring programs\n* [ ] Refactoring the hugo code and glue code behind the site\n\nSee the [Issues] for tasks and projects in progress\n\n### Code of conduct\n\nParticipation in the Kubernetes community is governed by the\n[Kubernetes Code of Conduct](code-of-conduct.md).\n\n[hugo]: https://gohugo.io/\n[Markdown]: https://www.markdownguide.org/\n[ct]: ./content/\n[pr]: https://help.github.com/en/articles/about-pull-requests\n[hugo-docs]: https://gohugo.io/getting-started/installing\n[npm]: https://nodejs.org/en/download/package-manager\n[frontmatter]: https://gohugo.io/content-management/front-matter/\n[docker]: https://www.docker.com/get-started\n[sig-contribex]: https://git.k8s.io/community/sig-contributor-experience/README.md\n[sig-contribex-slack]: http://slack.k8s.io/#sig-contribex\n[sig-contribex-list]: https://groups.google.com/forum/#!forum/kubernetes-sig-contribex\n[kep-2225]: https://github.com/kubernetes/enhancements/tree/master/keps/sig-contributor-experience/2225-contributor-site\n[docsy]: https://docsy.dev\n[postcss-cli]: https://postcss.org/\n[autoprefixer]: https://github.com/postcss/autoprefixer\n[git submodule]: https://git-scm.com/book/en/v2/Git-Tools-Submodules\n[Issues]: https://github.com/kubernetes/contributor-site/issues\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubernetes%2Fcontributor-site","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkubernetes%2Fcontributor-site","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubernetes%2Fcontributor-site/lists"}