{"id":20364468,"url":"https://github.com/justwriteclick/docs-like-code-stories","last_synced_at":"2026-02-10T00:31:11.800Z","repository":{"id":56445476,"uuid":"71665551","full_name":"justwriteclick/docs-like-code-stories","owner":"justwriteclick","description":"Collection of use cases for Docs Like Code website","archived":false,"fork":false,"pushed_at":"2020-11-07T02:14:34.000Z","size":664,"stargazers_count":10,"open_issues_count":0,"forks_count":7,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-08-15T21:56:01.413Z","etag":null,"topics":["docs-as-code","documentation","review","story","workflow"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","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}},"created_at":"2016-10-22T21:04:22.000Z","updated_at":"2022-11-16T02:20:36.000Z","dependencies_parsed_at":"2022-08-15T18:50:48.378Z","dependency_job_id":null,"html_url":"https://github.com/justwriteclick/docs-like-code-stories","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/justwriteclick/docs-like-code-stories","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justwriteclick%2Fdocs-like-code-stories","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justwriteclick%2Fdocs-like-code-stories/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justwriteclick%2Fdocs-like-code-stories/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justwriteclick%2Fdocs-like-code-stories/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/justwriteclick","download_url":"https://codeload.github.com/justwriteclick/docs-like-code-stories/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justwriteclick%2Fdocs-like-code-stories/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29287365,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-09T21:57:15.303Z","status":"ssl_error","status_checked_at":"2026-02-09T21:57:11.537Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["docs-as-code","documentation","review","story","workflow"],"created_at":"2024-11-15T00:12:06.211Z","updated_at":"2026-02-10T00:31:11.774Z","avatar_url":"https://github.com/justwriteclick.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# docs-like-code-stories\n\nCollection of use cases for Docs Like Code.\n\nThere are great stories out there; let's make them accessible to everyone.\n\nThe vision here is to provide the spark for more teams to think about their documentation in new ways. Read about automation, reviews, integration points, and get inspired to try some small changes yourself. \n\nSend in a Pull Request for review, writing in Markdown. Use any headings you want, but an outline could be:\n\n```\n\n# Use Case: \u003ccompany or organization name\u003e\n\n## What we build\n\n## Why we chose these techniques\n\n## Audience considerations\n\n## Reviews\n\n## Publishing\n\n## Automation\n\n## Version control and workflow\n\n## Benefits\n\n## Cautionary tales\n\n## What you wish you knew\n\n```\n\nLet's get these stories out into the world!\n\n## General questions for each use case\n\nWhat site or sites do you create from a repository source? What are the repositories that build the deliverables? Can you give an idea of the size, such as how many pages (source and output)? If they're private, that's fine too, talk about what led to that decision.\n\nWhat factors led your team to choose a development approach for docs? Why and when was it chosen?\n\nWhat type of audience are you writing for? Do your readers write with you? If so, how?\n\nHow active is your review queue? How often do you publish?\n\nIs your version control system \"pessimistic\" with single checkouts and file locking? Or is it \"optimistic\" with multiple people working on the same files at the same time? Do you merge or rebase? Have you kept the same workflow always? How long has the workflow been in place? \n\nWhat's your biggest win from using a developer workflow for docs? Tell a story. \n\nWhat would you warn others about when thinking about using development tools and workflows for docs? \n\nWould you suggest migrating content or only building new in this system? \n\nDo you have automation? If so, what type or tooling, and where is the automation in the workflow? \n\nAre there any questions you wish you had asked before treating docs like code?\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustwriteclick%2Fdocs-like-code-stories","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjustwriteclick%2Fdocs-like-code-stories","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustwriteclick%2Fdocs-like-code-stories/lists"}