{"id":20364455,"url":"https://github.com/justwriteclick/docslikecode","last_synced_at":"2025-10-26T12:03:15.014Z","repository":{"id":10889591,"uuid":"67373122","full_name":"justwriteclick/docslikecode","owner":"justwriteclick","description":"Read stories, learn through practice, share with others, to treat docs as code.","archived":false,"fork":false,"pushed_at":"2024-12-06T02:27:45.000Z","size":48454,"stargazers_count":45,"open_issues_count":3,"forks_count":15,"subscribers_count":5,"default_branch":"build","last_synced_at":"2024-12-06T03:24:59.243Z","etag":null,"topics":["cicd","docops","docs-as-code","documentation","documentation-code","netlify","ruby","ssg","website"],"latest_commit_sha":null,"homepage":"https://www.docslikecode.com","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/justwriteclick.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":"2016-09-04T23:16:20.000Z","updated_at":"2024-12-06T02:27:50.000Z","dependencies_parsed_at":"2024-12-06T03:32:54.553Z","dependency_job_id":null,"html_url":"https://github.com/justwriteclick/docslikecode","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/justwriteclick%2Fdocslikecode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justwriteclick%2Fdocslikecode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justwriteclick%2Fdocslikecode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justwriteclick%2Fdocslikecode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/justwriteclick","download_url":"https://codeload.github.com/justwriteclick/docslikecode/tar.gz/refs/heads/build","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230400616,"owners_count":18219831,"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":["cicd","docops","docs-as-code","documentation","documentation-code","netlify","ruby","ssg","website"],"created_at":"2024-11-15T00:11:58.227Z","updated_at":"2025-10-26T12:03:14.948Z","avatar_url":"https://github.com/justwriteclick.png","language":"HTML","readme":"# Docs Like Code\n\n[![Netlify Status](https://api.netlify.com/api/v1/badges/a47374ca-f840-4191-b695-f34651a2078c/deploy-status)](https://app.netlify.com/sites/docs-like-code/deploys)\n\n## The Website\n\nThis website is intended to offer stories and articles about how to treat docs like code, and lessons learned along the way. You are welcome to tell your story here as well.\n\n## To Contribute\n\nYou can directly submit a pull request using the fork-and-pull workflow to add an article, or submit to the [justwriteclick/docs-like-code-stories](https://github.com/justwriteclick/docs-like-code-stories) repo if you want to follow a question-and-answer template.\n\nPushing to the `build` branch lets you preview the build output using Netlify. You must log into Netlify to view the preview deploy.\n\nPushing to the `main` branch builds output to https://www.docslikecode.com using Netlify. Auto publishing is on as a setting in Netlify, so deploys from `main` are published automatically.\n\n## Theme Colophon\nTheme courtesy of https://mmistakes.github.io/so-simple-theme/\n\n## To Build Locally (MacOS)\n\nTest your additions and changes to content by running a local build.\n\nOn macOS you need to install brew, bundler.io, and Ruby version manager so that you can use a particular version of Ruby:\n\n1. Use brew to install a Ruby version manager.\n\n   ```\n   $ brew install rbenv ruby-build\n   ```\n\n1. Add rbenv to bash so that it loads every time you open a terminal. If you are using macOS Catalina, your profile file may be `.zshrc`.\n\n   ```\n   $ echo 'if which rbenv \u003e /dev/null; then eval \"$(rbenv init -)\"; fi' \u003e\u003e ~/.bash_profile\n   ```\n   or\n   ```\n   $ echo 'if which rbenv \u003e /dev/null; then eval \"$(rbenv init -)\"; fi' \u003e\u003e ~/.zshrc\n   ```\n\n1. Source your `.bash_profile` file. If you are using macOS Catalina, your profile file may be `.zshrc`.\n\n   ```\n   $ source ~/.bash_profile\n   ```\n   or\n   ```\n   $ source ~/.zshrc\n   ```\n\n1. Install the required Ruby version:\n\n   ```\n   $ rbenv install 2.7.1\n   $ rbenv global 2.7.1\n   $ rbenv version\n   ```\n   In return, you should see `ruby 2.7.1 2.7.1 (set by /Users/username/docslikecode/.ruby-version`.\n\n1. Run `gem install bundle` to install the bundler gem, which helps with Ruby dependencies.\n1. Run `bundle install` the first time you are in the `docslikecode` directory.\n\nTo build locally:\nOnce you have completed preparing your environment, then you can build locally and review the site in your browser.\n\n1. Run the serve command.\n\n   ```\n   $ bundle exec jekyll serve\n   ```\n\n1. Use the **Server address** URL  `http://127.0.0.1:4000/` in a browser to preview the content.\n1. Press `Ctrl+C` in the serve terminal to stop the server.\n\n\u003e ***Tip***  \n\u003e Leave the serve terminal open and running. Every time you save changes to a file, it automatically regenerates the site so you can test the output immediately. The only file where changes require a restart is the `_config.yml` file.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustwriteclick%2Fdocslikecode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjustwriteclick%2Fdocslikecode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustwriteclick%2Fdocslikecode/lists"}