{"id":13700258,"url":"https://github.com/emberjs/guides","last_synced_at":"2026-01-11T00:43:16.656Z","repository":{"id":19520292,"uuid":"22767401","full_name":"emberjs/guides","owner":"emberjs","description":"This repository is DEPRECATED!","archived":true,"fork":false,"pushed_at":"2018-05-11T03:04:51.000Z","size":39777,"stargazers_count":281,"open_issues_count":70,"forks_count":864,"subscribers_count":36,"default_branch":"master","last_synced_at":"2025-09-26T12:33:58.150Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/ember-learn/guides-source","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/emberjs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-08-08T18:25:02.000Z","updated_at":"2025-04-26T15:37:43.000Z","dependencies_parsed_at":"2022-08-05T04:17:46.555Z","dependency_job_id":null,"html_url":"https://github.com/emberjs/guides","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/emberjs/guides","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emberjs%2Fguides","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emberjs%2Fguides/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emberjs%2Fguides/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emberjs%2Fguides/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/emberjs","download_url":"https://codeload.github.com/emberjs/guides/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emberjs%2Fguides/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":277177847,"owners_count":25774347,"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","status":"online","status_checked_at":"2025-09-27T02:00:08.978Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-08-02T20:00:52.373Z","updated_at":"2025-09-27T03:30:26.367Z","avatar_url":"https://github.com/emberjs.png","language":"CSS","funding_links":[],"categories":["CSS"],"sub_categories":[],"readme":"# **Notice:** This repository is deprecated\n\nWe have been working hard to make it much easier to contribute to the Ember Guides over the last 6 months. As part of this process we have re-architected the Ember Guides so they are now a fully-fledged Ember application 🎉\n\nWhat does this mean right now? At the time of writing we have not swapped over to the new structure but we want to keep the swap-over time to a minimum. If you want to contribute to the guides from now on you should **contribute to the new infrastructure** instead of this repo.\n\nIf you want to contribute to the **content** of the guides then make a PR on the new [guides-source repo](https://github.com/ember-learn/guides-source). This repo is almost 100% markdown and represents the content of the guides.\n\nIf you want to contribute to **how the guides are displayed** then you will probably want to contribute to the [new guides-app](https://github.com/ember-learn/guides-app). We will be updating the contributing guides as part of this new deployment.\n\n## Ember Guides\n[![Build Status](https://travis-ci.org/emberjs/guides.svg?branch=master)](https://travis-ci.org/emberjs/guides)\n\nThis is the source for the [Ember.js Guides](https://guides.emberjs.com).\n\nLooking for repositories for other parts of the site? Check out\n[website](https://github.com/emberjs/website),\n[ember-api-docs](https://github.com/ember-learn/ember-api-docs),\n[super-rentals tutorial](https://github.com/ember-learn/super-rentals),\n[statusboard](https://github.com/ember-learn/statusboard),\nand [styleguide](https://github.com/ember-learn/ember-styleguide)\n\n## Contributing\n\nWelcome and thanks for your help! Please see [CONTRIBUTING.md](CONTRIBUTING.md)\nfor detailed instructions on how to format your work and submit a Pull Request.\n\n## Project layout\n\nThe Guides content takes the form of Markdown files (just like most READMEs).\nThe Guides themselves are in the `source` folder. The left nav bar is produced from\n`data/pages.yml`. `lib` contains Middleman plugins, and `spec` contains tests\nfor those plugins.\n\n## Running locally with Docker (recommended)\n\nThis is the recommended method for new contributors.\nAlthough the Guides are built with Ruby, most work is done in Markdown files.\nYou don't need to know Ruby or install its dependencies to help out. Simply follow\nthe Docker container instructions below to install and run locally.\n\nFirst, install [Docker and Compose](https://store.docker.com/search?offering=community\u0026type=edition) and leave it running.\n\nNext, the commands below will install all necessary dependencies for the Guides\napp and start a server. This will take a little while to run,\npossibly a few minutes. The dependencies will be installed inside a Docker\ncontainer, and do not affect your normal developer environment.\n\n```sh\ngit clone git://github.com/emberjs/guides.git\ncd guides\ndocker-compose build\ndocker-compose up\n```\n\nYou can view the site locally at [http://localhost:4567](http://localhost:4567)\n\n## Running locally with Ruby and Middleman\n\nThe Docker method described above is recommended over installing dependencies\nseparately. However, if necessary, these are the manual steps. The Guides are built\nwith Middleman, which runs on Ruby 1.9.3 or newer.\n\nMac users should install Ruby using rbenv to avoid changing their OS dependencies:\n\n```\nbrew install rbenv\n```\n\nFollow the [rbenv installation instructions](https://github.com/rbenv/rbenv) to install the Ruby version specified [here](.ruby-version), then go through the init steps, set a global version, and restart the terminal. If `gem env home` shows rbenv in the path, your installation was successful. You should not have to sudo install any gems.\n\nOnce you have installed Ruby, you will need bundler and Middleman:\n\n```\ngem install bundler middleman\n```\n\nDuring build, Middleman will require Aspell to look for misspellings. On Macs, it can be installed via Homebrew:\n\n``` sh\nbrew install aspell --with-lang-en\n```\n\nOn Windows, you can download an [installer](http://aspell.net/win32/), but unfortunately it is unmaintained. On Linux, you can install with your distribution's package manager. On all platforms, you can also [build the most recent version from source](http://aspell.net/man-html/Installing.html).\n\nSome Mac users may also need to install openSSL, which will be indicated in an error during the bundle command. See [Troubleshooting.md](TROUBLESHOOTING.md).\n\nTo get started:\n\n#### Local Dev\n``` sh\ngit clone git://github.com/emberjs/guides.git\ncd guides\nbundle\nbundle exec middleman\n```\n\n#### Viewing\n\nThen visit [http://localhost:4567/](http://localhost:4567/).\n\nIf you run into problems, check [Troubleshooting.md](TROUBLESHOOTING.md).\n\n### Spellchecking\n\nIf you have a false hit during spellchecking, you can add the word to `/data/spelling-exceptions.txt`.\nWords are line separated and case insensitive.\n\n# Maintainers\n\nSee [MAINTAINERS.md](MAINTAINERS.md).\n\n# Releasing\n\nSee https://github.com/emberjs/guides.emberjs.com.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femberjs%2Fguides","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femberjs%2Fguides","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femberjs%2Fguides/lists"}