Skip to content

Latest commit

 

History

History
703 lines (468 loc) · 37 KB

CHANGELOG.md

File metadata and controls

703 lines (468 loc) · 37 KB
Raw

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

Unreleased

Welcome to our newest user, atalaya and Reaction Commerce

Thank you to the following contributors who helped with this release:

  • @endiliey
  • @joelmarcey
  • @yangshun
  • @dballance
  • @helloworld
  • @jreese
  • @machikoyasuda
  • @parano
  • @steevehook
  • @theletterf

Added

  • Add autoprefixing to CSS pipeline #867
  • Add documentation regarding usage of nested docs/ subdirectory #860
  • Support text language for code block style without any highlighting #875

Fixed/Changed

  • Fix wrong CSS language prefix for fenced blocks #842 #870
  • Fix table of contents documentation typo #873
  • Don't replace static assets linking in fenced code blocks #864
  • Improve baseUrl documentation with an example #863
  • Docusaurus own search will now search the docs in the correct language & version #859
  • Fix phrase emphasis not italicized #850
  • Blogpost summary for blog feed is now properly truncated #880

Chore and Maintenance

1.3.2 - 2018-07-06

This version mainly includes bug fixes found in 1.3.1 that improves stability and UX improvements.

Welcome to our newest user, single-spa, a framework that allows you to use multiple front end frameworks in one SPA.

Thank you to the following contributors who helped with this release:

  • @endiliey
  • @chenglou

Fixed/Changed

  • Fix wrong sitemap for alternate URLs (#828)
  • Publish-gh-pages should display the correct commit that triggers it (#829)
  • Fix missing Facebook like buttons in blog posts (#821)
  • Open browser with the correct baseUrl during development (#819)
  • Fix Edit button alignment in Docs (#819)

1.3.1 - 2018-06-30

This version mainly includes bug fixes found in 1.3.0 that improves stability.

Thank you to the following contributors who helped with this release:

  • @endiliey
  • @yangshun
  • @RhysBower
  • @ngyikp

Fixed/Changed

1.3.0 - 2018-06-20

1.3.0 introduces a brief clean up of our CSS, overall site typography and some improvements to Algolia search.

Welcome to our newest user, ml5, a really cool machine library in JavaScript.

Thank you to the following contributors who helped with this release:

  • @endiliey
  • @JoelMarcey
  • @yangshun

Breaking changes

  • Since we made some CSS changes, there's a good chance it might not be compatible with your custom CSS if you have any. We recommend that you audit each page of the site for any UI issues caused by this change. We'll try to minimize such backward-incompatible CSS changes in future.
  • Other UI changes include:
    • Left sidebar is sticky by default on supported browsers. We saw many of our users write custom CSS for that behavior and decided to incorporate it in the core.
    • Footer is now a darker shade of black for better contrast.
    • Background color of site changed to #fff.
    • Headers are now black (from $primaryColor) and have bolder font weight.
    • Blockquotes are changed to yellow (from pink).

Fixed/Changed

  • The search input will now search the docs in the correct language.
  • Algolia will be able to scrap emulti-language and/or versioned sites better with the introduction of special meta tags.

Added

N/A

Removed

N/A

1.2.1 - 2018-06-17

Fixes from existing issues and those found in the 1.2.0 release. Fixes include being able to modify the metadata of a doc without resorting to deleting en.json, using absolute URLs instead of relative for docs links, and more. We also added a few new things as well.

Welcome to our newest users, Babel, Sonar, Metro, StreamPipes, and rest-hapi.

Thank you to the following contributors who helped with this release:

  • @endiliey
  • @yangshun
  • @Kelltimo
  • @ayshiff
  • @rupeshparab
  • @gustavohenke
  • @maxogden
  • @jonathaningram
  • @dominikriemer
  • @anru
  • @Rendez
  • @Thai56
  • @JKHeadley

Breaking changes

  • This may not affect many users, but if you modified the en.json to add your own custom translation strings, we changed how this is handled, and you will need to follow the instructions here to modify your setup.

Added

Fixed/Changed

  • 1.2.0 introduced a bug where you could not update documentation metadata without deleting en.json. This has been fixed as part of the custom translation string breaking change.
  • Absolute URLs are now used instead of relative URLs for documentation linking to avoid trailing slash issues.
  • If you have had trouble updating Docusaurus, it may have been your Babel cache.
  • No more errors if heading anchors are empty.
  • Fixed bug when renaming version where sidebars.json were not getting updated.
  • Table of contents are now hidden when onPageNav is not separate.

Removed

N/A

1.2.0 - 2018-06-10

A major point release. This release adds highly requested features, including extension-less URLs, nested directories for docs and adding a second option (Prism) for syntax highlighting.

Welcome to our newest users, pnpm and Anssr Data.

A special thank you to @endiliey who has come in and did awesome work for Docusaurus. @endiliey is now an official maintainer of the Docusaurus repo because of his efforts.

Thank you to the following contributors who helped with this release:

  • @endiliey
  • @yangshun
  • @gimdongwoo
  • @balloob
  • @zkochan
  • @gustavohenke
  • @ranolf
  • @Themandunord
  • @ericnakagawa
  • @vacarsu
  • @SleepWalker
  • @brenopolanski
  • @skratchdot

Breaking changes

None that we know of. Please let us know if you find any as this is a big release and we may have missed something.

Added

Fixed/Changed

  • For better SEO, we now support meta:description.
  • Existing translation files are now loaded correctly.
  • URLs properly resolve no matter which language you are currently viewing.
  • Atom and RSS feed links are fixed for xxx.github.io sites.
  • Version pages link to the correct language, depending on the current language.
  • Do not start server if versions.js is missing and versioning is enabled.
  • Fail properly when current branch is the same as the deployment one.
  • Assets not found bug fixed in Windows.
  • OnPageNav now works on mobile devices.
  • Remove extra padding in code blocks.
  • Better gitignore for docusaurus-init
  • Documentation fixes: 123.

Removed

N/A

1.1.5 - 2018-05-26

Hotfix. A package in devDependencies needed to be moved to dependencies.

1.1.4 - 2018-05-25

Yet another hotfix release. We found an issue with the way we did LiveReload - we were watching the node_modules directory and that caused some users to encounter errors. We stopped watching node_modules directory in gaze.

Thank you to the following contributors who helped with this release:

  • @artiebits
  • @yangshun

Fixed/Changed

1.1.3 - 2018-05-23

npm had an issue where some packages were not being published. This should hopefully be resolved now; publishing a new version just in case.

Also, welcome TextLint and Open Power Quality as new users.

Thank you to the following contributors who helped with this release:

  • @azu
  • @philipmjohnson
  • @violabg
  • @sebelga

Fixed/Changed

  • onPageNav now shows in Safari.

1.1.2 - 2018-05-21

Another HOTFIX release. One of our third-party dependencies, tree-node-cli didn't support Node 10+. The package has been fixed and we have updated to use the new version of that package.

1.1.1 - 2018-05-21

HOTFIX release. Dependency bug found.

Fixed/Changed

  • opn needs to be installed, not just in dev dependencies.

1.1.0 - 2018-05-20

This is our first major point release. There are three primary reasons for this:

There are a lot of other fixes and enhancements as well. Also, we have five new users of Docusaurus within this release as well. Thank you to WarriorJS, Bemuse, Pyre-Check, Draft.js and CaptainDuckDuck for using Docusaurus.

There are also various documentation fixes as well.

We think this is a good release.

Thank you to the following contributors who helped with this release:

  • @yangshun
  • @amyrlam
  • @gedeagas
  • @ahmadalfy
  • @endiliey
  • @zpao
  • @NoamELB
  • @sujono91

Breaking Changes

Added

  • Live Reload allows you to make changes to your documentation without having to manually refresh your site.
  • Running yarn start or npm start automatically opens a browser to the correct localhost page.
  • There is now a build option, --skip-image-compression, to compress your images.
  • You can now add Twitter and Facebook social buttons to the footer.
  • The blog now allows for Facebook-based comments.
  • A warning is now shown if you use versioning without a version.js file.

Fixed/Changed

  • Various UI fixes
  • Directory tree printed during docusaurus-init.

Removed

[1.0.15] - 2018-05-06

This release has a lot of commits, including bug fixes, documentation updates, as well as a bit of new functionality. A new blog post from @caabernathy about how easy it is to create a Docusaurus site, a lot of Windows fixes, the ability to specify the default version shown, and more.

Thank you to the following contributors who have helped with this release:

  • @yangshun
  • @amyrlam
  • @caabernathy
  • @szeck87
  • @dgracehmh
  • @balloob
  • @ramiel
  • @AmitHarlev
  • @pixelastic
  • @SoonaMata
  • @olistic
  • @SleepWalker
  • @Airse
  • @ahmadalfy
  • @zenflow

Breaking changes

N/A

Added

Fixed/Changed

Removed

N/A

1.0.14 - 2018-04-23

Small release mostly for documentation.

Thank you to the following contributors who have helped with this releae:

  • @yangshun
  • @ericnakagawa
  • @shikaan
  • @longility

Breaking changes

N/A

Added

N/A

Fixed/Changed

  • Blog metadata now refreshed on changes to blog posts.

Removed

N/A

1.0.13 - 2018-04-20

This is primarily a bug fix release.

Thank you to the following contributors who helped with this release:

  • @vjeux
  • @huang-x-h

Breaking changes

N/A

Added

Fixed/Changed

  • Do not warn when using layout in the docs metadata header.
  • Restore the ability to use the --port command line argument

Removed

N/A

1.0.12 - 2018-04-18

This is a general release with additions and documentation updates. We would also like to welcome React Native Elements as a user of Docusaurus.

https://docusaurus.io has turned on versioning. There are other documentation updates as well.

We turned on translations, but found a bug. So we turned it off until we fix it.

Thank you to the following contributors who helped with this release:

  • @yangshun
  • @amyrlam
  • @SleepWalker
  • @InternetExplorer7
  • @zkochan
  • @iRoachie
  • @limonte

Breaking changes

Added

Fixed/Changed

Removed

N/A

1.0.11 - 2018-04-12

This is a general release with additions and documentation updates (which are already live on docusaurus.io). We would also like to welcome BlueWhale as a new user of Docusaurus.

Thank you to the following contributors who helped with this release:

  • @amyrlam
  • @yangshun
  • @aadsm
  • @InternetExplorer7
  • @MisterTea
  • @SBrown2

Breaking changes

N/A

Added

Fixed/Changed

  • If you have translations enabled, the language drop down in the header navigation bar is now fixed to show the current language.
  • More accessibility fixes to support a11y.

Removed

N/A

1.0.10 - 2018-04-09

This is a general release with mostly bug fixes and documentation updates (which are already live on docusuarus.io).

Breaking Changes

N/A

Added

Fixed/Changed

Removed

N/A

1.0.9 - 2018-03-13

This is a hotfix release

A bug was found in the using path functions commit by @sunnylqm. Total commits in this release is 4, including the release itself.

Breaking Changes

N/A

Added

Fixed/Changed

Removed

N/A

1.0.8 - 2018-03-12

This is a targeted feature and bug fix release. A couple of things of interest are that this release fixes some issues with Windows that were occurring, particularly when building the docs, both locally and publishing, as well as addressing an issue for support for a secondary, on-page sidebar for local page navigation, which is now enabled for docusaurus.io. Total commits in this release is 27, including the release itself.

Breaking Changes

N/A

Added

Fixed/Changed

Removed

N/A

1.0.7 - 2018-02-17

This is a hotfix release

A couple of bugs were found in our versioning system that would make versioning unusable in some scenarios. Thank you to @iRoachie for finding these. This release also contains a better header link scroll on mobile. Total commits in this release is 6, including the release itself.

Breaking Changes

N/A

Added

Fixed/Changed

Removed

N/A

1.0.6 - 2018-02-12

This is a bigger release than normal as it has been a month since releases. It contains bug fixes, duplicate code removal, a few new features, and documentation updates. Total commits in this release is 38, including the release itself.

Breaking Changes

N/A

Added

Fixed/Changed

  • Blog feeds now show HTML, not markdown (#407, thanks @tom-auger)
  • Chinese translation infra (#377, thanks @chenglou)
  • Margin for right-aligned images (#398, thanks @rickhanlonii)
  • Correct HTTP status code sent on redirects (#408)
  • Non-English versioned docs metadata parsed correctly (#412, thanks @sunnylqm)
  • Provide Algolia information about the latest and current version (#418)
  • Remove key errors when running local server (#425, thanks @hshoff)
  • Links fixed in blog Atom feed (#421, thanks @hramos)

Removed

N/A

1.0.5 - 2018-01-09

This is a targeted bug fix release, with some documentation updates and Docusaurus repo housekeeping in between. Total commits in this release is 13, including the release itself.

Breaking Changes

N/A

Added

N/A

Fixed/Changed

  • Docusaurus builds on Windows (PR #381, thanks @qcz).
  • Fixed publishing for user/org GitHub sites (as opposed to project sites) (PR #384).
  • Clarification and updates on the publishing and API documentation (PR #372).

Removed

N/A

1.0.4 - 2017-12-27

This is generally a bug fix release, with some code refactoring. Total commits in this release is 58.

Breaking Changes

  • Most users may not run into this problem, but we think it can technically be a breaking change. PR #322 (original PR #316) and friends changes the way we check for the existence of translations and versioning. Part of that is that we allow for the possibility of an empty language prop, instead of defaulting everything to English. When running 1.0.4, check to make sure your index.js works as expected. See this comment and those below for discussion on this. There is still a bit more work to be done (refactoring and maybe adding a defaultLang config option) to make this as clean as possible.

Added

  • lang property added on html tag, if a language exists and is set (PR #295).
  • Added the wrapPagesHTML configuration option (PR #332).
  • Some adming docs on how to debug with VSCode (PR #335).
  • Added docs for the useEnglishURL configuration option.

Fixed/Changed

  • Links on landing page in docusaurus-init test site do not 404 any longer.
  • Refactoring how we check for translations and versioning (PRs #322/#316 and friends).
  • Refactored the example index.js page (PR #293).
  • Link errors, typos and grammatical errors in the docusuarus.io documentation.

Removed

N/A

[1.0.3] - 2017-12-13

Added

  • Docusaurus released to the public.
    • Initialization script
    • Versioning
    • Translations
    • Search
    • Blog
    • Documentation