{"id":13836269,"url":"https://github.com/dctacademy/docs-format","last_synced_at":"2025-07-10T13:32:29.453Z","repository":{"id":123745801,"uuid":"150413199","full_name":"dctacademy/docs-format","owner":"dctacademy","description":"This repository provides best practices for writing documentation and basic folder structure that has to be followed while writing Node app (or any app in general)","archived":false,"fork":false,"pushed_at":"2019-09-03T09:30:34.000Z","size":30,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-11-20T22:52:32.567Z","etag":null,"topics":["docs","documentation","node-js","readme","readme-template"],"latest_commit_sha":null,"homepage":null,"language":null,"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/dctacademy.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}},"created_at":"2018-09-26T11:04:17.000Z","updated_at":"2019-09-03T09:30:36.000Z","dependencies_parsed_at":"2024-01-15T19:44:22.872Z","dependency_job_id":"46f99eca-eb48-47d3-aec4-c638de7f009a","html_url":"https://github.com/dctacademy/docs-format","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dctacademy/docs-format","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dctacademy%2Fdocs-format","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dctacademy%2Fdocs-format/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dctacademy%2Fdocs-format/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dctacademy%2Fdocs-format/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dctacademy","download_url":"https://codeload.github.com/dctacademy/docs-format/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dctacademy%2Fdocs-format/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264585372,"owners_count":23632646,"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":["docs","documentation","node-js","readme","readme-template"],"created_at":"2024-08-04T15:00:40.284Z","updated_at":"2025-07-10T13:32:28.962Z","avatar_url":"https://github.com/dctacademy.png","language":null,"funding_links":[],"categories":["Documentation"],"sub_categories":[],"readme":"# DCT Academy's Documentation Format\n\nThis repository provides best practices for writing documentation and basic folder structure that has to be followed while writing Node app (or any app in general). \n\n**Note:** You can use a tool like [README.md Genearator](https://github.com/kefranabg/readme-md-generator) to ease up your process.\n\nIn order to write documentation on GitHub, you have to first understand Markdown, a standard used by GitHub to accept documentation. \n\n* Learn more about Markdown [here](https://en.wikipedia.org/wiki/Markdown)\n* Learn how to use Markdown [here](https://www.markdowntutorial.com/)\n* Find Markdown cheatsheet [here](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet)\n\nExamples of a good documentation:\n* [Node.js](https://github.com/nodejs/node) GitHub repository\n* [React.js](https://github.com/facebook/react) GitHub repository\n* [Bootstrap](https://github.com/twbs/bootstrap) GitHub repository\n\n\u003e Do not include the above paragraph in your documentation.\n\n---\n\n# Project Title\n\nWrite your project overview here. A short description about your project and what it does. It should also provide details, links, algorithms or other resources like tutorials, links to articles and research papers, used in the application.\n\nOne to two paragraph statement about your product and what it does. Add a screenshot (user logged in) as shown below.\n\n![Sample Image](https://via.placeholder.com/1000x450)\n\n# Installation/Development\n\nImagine a new developer who wants to use/run your project. It's a good practice to write all the tools, dependencies and versions of packages that you have used in your app. You can exclude trivial dependencies and only include that you have used specific to this project. There are chances that the developer might be using a different operating system or an environment.\n\nOperating System 1:\n\n```\nnpm install \u003cpackage-name\u003e\n```\n\nOperating System 2:\n\n```\nnpm install \u003cpackage-name\u003e\n```\nDescribe how to install all development dependencies and how to run an automated suite. Potentially do this for multiple platforms\n\n* Packages 1/Dependencies 1\n* Packages 2/Dependencies 2\n* Packages 3/Dependencies 3\n* .\n* .\n* Packages N/Dependencies N\n\n# Usage \nWrite a brief description on how to use your project/app. Write about the features involved, different ways of using your app. Explain like you are explaining this to your customer or client. Use bullet points if necessary.\n\n[Demo](https://\u003cdemo-link\u003e.com)\n\nPost a demo link along with demo login credentials if your app is successfully deployed.\n\n# Credits\nGive out credits to all the people who have helped you in building this application.\n\n* [Link to Person 1's profile](https://\u003clink-to-person1s-profile\u003e/), This Position at That Company\n* [Link to Person 2's profile](https://\u003clink-to-person2s-profile\u003e/), This Position at That Company\n* [Link to Person N's profile](https://\u003clink-to-personNs-profile\u003e/), This Position at That Company\n\n# License\n\nCopyright(c) {year of production}, [Link to your company/organisation](https://www.yourorg.com)\n\nAdd a few lines about who can use your open-source project, its liabilites and legal content (if necessary). Use can use either an [MIT License](https://opensource.org/licenses/MIT) or an [Apache 2.0 License](https://www.apache.org/licenses/LICENSE-2.0) for the same. (A sample of MIT License is provided in the template code of this repository)\n\nLearn more about open-source licenses [here](https://help.github.com/articles/licensing-a-repository/)\n\n# Authors\nList of Authors, Developers and Designers of this app are listed here including yourself.\n\n* [Link to Author 1's profile](https://\u003clink-to-author1s-profile\u003e/), This Position at That Company\n* [Link to Author 2's profile](https://\u003clink-to-author2s-profile\u003e/), This Position at That Company\n* [Link to Author N's profile](https://\u003clink-to-authorNs-profile\u003e/), This Position at That Company\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdctacademy%2Fdocs-format","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdctacademy%2Fdocs-format","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdctacademy%2Fdocs-format/lists"}