{"id":16688008,"url":"https://github.com/danielpclark/lrtt","last_synced_at":"2025-03-13T17:27:18.790Z","repository":{"id":142007115,"uuid":"85072097","full_name":"danielpclark/lrtt","owner":"danielpclark","description":"Learn Ruby Through Testing — Test Driven Documentation","archived":false,"fork":false,"pushed_at":"2017-03-15T12:57:39.000Z","size":4,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-01-20T12:46:23.761Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","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/danielpclark.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"MIT-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":"2017-03-15T12:54:05.000Z","updated_at":"2017-03-15T12:57:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"2218eb2d-f5e1-4696-893e-4c008305bf18","html_url":"https://github.com/danielpclark/lrtt","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/danielpclark%2Flrtt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielpclark%2Flrtt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielpclark%2Flrtt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielpclark%2Flrtt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danielpclark","download_url":"https://codeload.github.com/danielpclark/lrtt/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243447642,"owners_count":20292455,"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-10-12T15:26:25.946Z","updated_at":"2025-03-13T17:27:18.763Z","avatar_url":"https://github.com/danielpclark.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Learn Ruby Through Testing\n\n**TEST DRIVEN DOCUMENTATION**\n\nThere are many \"documented\" things in Ruby which assume a certain level of understanding.\nEven with a vast understanding of Ruby itself these foreign concepts aren't understood by\nthe very basic description given in the documentation.  Without prior knowledge from another\nsystem or language it's difficult to derive what things are for and how they're supposed to\nbe used.  **The purpose of this project is to learn the difficult/foreign parts of ruby through\ntesting (TDD) and then write how-to READMEs on each subject.**  Any README or test is open\nto be improved upon and contribution to this project is encouraged.\n\nThe structure for this will be straight forward: Every subject will get its own folder in the\n`doc` directory by its name in which a README.md will be put explaining a few core things (1)\nwhat (2) how it may be used with code block examples.  Directory structure in doc and test will\nbe reflected exactly as you would require it eg: in `doc` 'io/console/' would be two directories\neach with a README.md and in `test` io will be a test `test/io_test.rb` and console will be a test\nin a directory `test/io/console_test.rb`.\n\nFor now there is a lot of liberty in how this will be done.  When a test is being written in the\nred-green-refactor phase I'd like a comment to be written above the test about what is expected\n(as in 'I guess this works this way').  If there is no guess then you should have written in the\nREADME for library the (I know) 'this works this way'.  As a solid understanding of how it works\nis attained you may then remove the comment above the test providing that you've written\ndocumentation with examples.\n\nIt would be nice if conclusions in the READMEs have some description as to how you came about\nthat conclusion.\n\n# Areas of Interest\n\n_You may add to this list._\n\n* [ ] Process\n* [ ] Signal\n* [ ] DRb\n* [ ] Mutex_m\n* [ ] PTY\n* [ ] Fiber\n* [ ] Thread\n* [ ] WeakRef\n* [ ] Shell\n* [ ] Rinda\n\n\nThese can be marked as completed if documentation examples have been provided for all methods\nwithin them.  They're still open for updates afterwards.\n\n# Issues\n\nOpen as many issues as you'd like on Ruby's core or stdlib that you believe needs more explanation.\n\n# LICENSE\n\nThe MIT License (MIT)\n\nCopyright (C) 2017 by Daniel P. Clark \u0026 the Learn Ruby Through Testing Team\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielpclark%2Flrtt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanielpclark%2Flrtt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielpclark%2Flrtt/lists"}