Read either on the Ember blog or in our e-mail newsletter what has been going on in Emberland this week: We have some news for Ember CLI bundled up for you, as well as documentation highlights from the folks from ember-cli-addon-docs, a final reminder to hand in your Ember Roadmap blog post and a pretty big announcement from the Learning Team for you! 🙆🏾
Recently, lots of work has landed 🛬 in Ember CLI to bring the long-awaited Packager feature to life (1, 2, 3, 4, 5). The Packager will increase the flexibility of Ember's build pipeline, paving the way for other neat features like code splitting and tree shaking and finally allowing developers to further reduce the filesize of their applications by dramatic amounts.
Want a recap of what's in for the Packager feature? Be sure to check out both the the original RFC (Request for Comments) proposal, as well as this year's update that details the motivation behind it. And want to know when it will finally land for an Ember app near you? Of course we'll let you know ASAP 🔜 in one of the upcoming editions of the Ember.js Times!
The Guides are a cornerstone of the Ember experience, and one of our community's strengths is that anyone can get involved. So, it's important to make it easier for everyone to create content or functionality. For this reason, a team of contributors have been working for months to convert the Guides from a Ruby/Middleman app into an Ember app. Now, to help with content, contributors only need to work with markdown files, and to see how things would look on the website, they run an Ember app! ember-learn/guides-app contains the static site generator that pulls written content from guides-source markdown files. The guides-app produces static HTML using Prember and FastBoot. The app is currently served through Heroku who supports Ember in a big way by sponsoring hosting and advice. (Did you know that it takes a ton of back end infrastructure to run a front-end framework project? Other parts of our website rely on support from Fastly, like the API docs. We're thankful to have so many friends of open source 👨👩👧👦!)
Moving forward, the only part of our site that's not Ember is the website repo, which includes the home page, the blog, and some other odds and ends. Everything else has already been moved into Ember apps! If you want to help out, drop by the #team-learning channel.
The ember-cli-addon-docs are getting easier to use day-by-day, so there's no excuse to leave your software libraries undocumented anymore...
A real-world example of its usage is the ember-decorators documentation: ember-decorators, which was recently revamped by leveraging the add-on. Have a go at it and inspire yourself 👩🎨 to your own documentation!
Also, on the most recent releases, the following neatest features were made available:
- New version selector: good news for when you feel nostalgic about old documentation. Now you can add to your navigation a version selector control that will enable you to jump back and forth to different documentation versions with ease, check it out here. - "Magic mirror, on the wall – who is the most beautiful documentation of all?": ember-cli-addon-docs has an even prettier UI now thanks to ember-cli-tailwind. If you are unfamiliar with Tailwind, do yourself a favour and deep dive into its power here.