{"id":23066996,"url":"https://github.com/dvsa/mot-docs","last_synced_at":"2025-04-03T09:13:49.809Z","repository":{"id":86167423,"uuid":"88750778","full_name":"dvsa/mot-docs","owner":"dvsa","description":"Web based technical documentation for the MOT service","archived":false,"fork":false,"pushed_at":"2017-11-24T06:40:01.000Z","size":6728,"stargazers_count":0,"open_issues_count":1,"forks_count":3,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-02-08T22:28:34.717Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dvsa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-04-19T13:51:09.000Z","updated_at":"2024-01-03T09:12:53.000Z","dependencies_parsed_at":"2023-03-13T08:44:55.184Z","dependency_job_id":null,"html_url":"https://github.com/dvsa/mot-docs","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/dvsa%2Fmot-docs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dvsa%2Fmot-docs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dvsa%2Fmot-docs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dvsa%2Fmot-docs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dvsa","download_url":"https://codeload.github.com/dvsa/mot-docs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246970323,"owners_count":20862509,"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-12-16T05:15:53.722Z","updated_at":"2025-04-03T09:13:49.793Z","avatar_url":"https://github.com/dvsa.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Technical Documentation\n\n## Getting started\n\nTo preview or build the website, we need to use the terminal.\n\nInstall Ruby with Rubygems, perferably with a [Ruby version manager][rvm],\nand the [Bundler gem][bundler].\n\nIn the application folder type the following to install the required gems:\n\n```\nbundle install\n```\n\n## Making changes\n\nTo make changes edit the source files in the `source` folder.\n\nAlthough a single page of HTML is generated the markdown is spread across\nmultiple files to make it easier to manage. They can be found in\n`source/documentation`.\n\nA new markdown file isn't automatically included in the generated output. If we\nadd a new markdown file at the location `source/documentation/agile/scrum.md`,\nthe following snippet in `source/index.html.md.erb`, includes it in the\ngenerated output.\n\n```\n\u003c%= partial 'documentation/agile/scrum' %\u003e\n```\n\nIncluding files manually like this lets us specify the position they appear in\nthe page.\n\n## Preview\n\nWhilst writing documentation we can run a middleman server to preview how the\npublished version will look in the browser. After saving a change the preview in\nthe browser will automatically refresh.\n\nThe preview is only available on our own computer. Others won't be able to\naccess it if they are given the link.\n\nType the following to start the server:\n\n```\nbundle exec middleman server\n```\n\nIf all goes well something like the following output will be displayed:\n\n```\n== The Middleman is loading\n== LiveReload accepting connections from ws://192.168.0.8:35729\n== View your site at \"http://Laptop.local:4567\", \"http://192.168.0.8:4567\"\n== Inspect your site configuration at \"http://Laptop.local:4567/__middleman\", \"http://192.168.0.8:4567/__middleman\"\n```\n\nYou should now be able to view a live preview at http://localhost:4567.\n\n## Build\n\nIf you want to publish the website without using a build script you may need to\nbuild the static HTML files.\n\nType the following to build the HTML:\n\n```\nbundle exec middleman build\n```\n\nThis will create a `build` subfolder in the application folder which contains\nthe HTML and asset files ready to be published.\n\n[rvm]: https://www.ruby-lang.org/en/documentation/installation/#managers\n[bundler]: http://bundler.io/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdvsa%2Fmot-docs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdvsa%2Fmot-docs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdvsa%2Fmot-docs/lists"}