![]() ![]() ![]() Ruby combines the best practices from various solutions to provide a unique object-oriented language, which aims for simplicity and provides such features as basic & special object-oriented features operator overloading exception handling iterators and closures garbage collection, and more. Stay in touch! Say hello to the DevDocs team on Twitter at or in the Community Engineering #devdocs Slack channel.Ruby is a popular, open source programming language with a powerful and practical, yet natural and easy to read/write syntax. Having trouble building the site? Get in touch with us on Slack in the #DevDocs channel and we will help you out. ![]() See the Building this site section of our GitHub wiki to get started. With the magic of Jekyll and Ruby you can easily spin up a generated website that auto-refreshes with your changes as you make them! You don’t need a fancy or complicated setup to serve the site locally for previewing purposes. This provides a layer of quality control before your pull request ever reaches our repo and the reviewing eyes of the Docs team. When contributing to our repos, such as DevDocs, MerchDocs, PWA Docs, etc., sometimes it’s helpful to actually see the changes you are iterating. Check out the Building old versions section of our GitHub wiki to learn how. You can also checkout the repo and its docs locally for a specific version point in time. Click the Tags tab in the Branches menu in our repo to select the version for which you want to see the repo and docs. Sometimes, though, you may need to see the docs at a certain point in time, or a certain version in time.Įnter version tags! Within GitHub in one of our docs repos, you can see everything in the source at a version point in time. Our published docs sites, like, include documentation for supported versions of Magento. This simple change removes a layer of uncertainty and ensures you can get to the content you need quickly. That’s right-Once you navigate to our Cloud docs you can read away, unhindered by version concerns. It’s rare that we need to do this, but when we do you won't miss it! When we need to, we bring attention to specific Magento version information via inline text right in the documentation. Our Cloud documentation is now applicable to the current version of Magento-always! Tired of reading a whole Cloud topic only to realize you’re reading info for a Magento version not applicable to you? We hear you, and we have a fix for that. Our Module Reference Guides, Backward Incompatible Changes Reference, and any files in the /data directory are all auto-generated and published in each release cycle. That’s it!ĭid you know we have a slew of docs content that is actually auto-generated? Auto-generating a portion of our docs content allows us to be more efficient with our time so we can work on complicated technical tutorials, information architecture advancements, and other pressing doc tasks that arise during the fast-paced software development process. Adding bookmarks to your browser is helpful, but who has time for that?! Switching between our docs sites is now easier than ever with the addition of our new site switcher.Ĭlick the grid icon in the top right-hand corner of any docs site and click the site you want to navigate to. Never again question whether a topic could use a refresh (and if it does, click Edit this page on GitHub and you’re off to the races)! ![]() We added a last edited date feature to our DevDocs site that shows you exactly how long ago it was revised.Ĭlick the X days ago text to get more detail. Now, it’s easy to see exactly when a topic was last edited. Some of this work goes widely unseen, but we have added new site features and implemented process enhancements that are helpful to our users and doc contributors. The Docs team here at Magento works diligently to provide documentation for all new features going out the door, chronicle it all in our release notes and What’s New topics, and update existing docs that need more context-all with the goal of improving user experience.Īlongside that feature development-centric work, we are also constantly maintaining and improving the infrastructure and usability of our documentation sites. ![]()
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |