diff --git a/CHANGELOG-2.x.md b/CHANGELOG-2.x.md
index 3bef14ea52..b680df2887 100644
--- a/CHANGELOG-2.x.md
+++ b/CHANGELOG-2.x.md
@@ -14,7 +14,7 @@
 - Code Blocks
   - Change default theme from Night Owl to Palenight
   - Slight tweaks to playground/preview components
-- Add `scripts` and `stylesheets` field to docusaurus.config.
+- Add `scripts` and `stylesheets` field to `docusaurus.config.js`
 - More documentation...
 
 ## 2.0.0-alpha.25
diff --git a/website/docs/migrating-from-v1-to-v2.md b/website/docs/migrating-from-v1-to-v2.md
index 2c1626e587..8601c8babf 100644
--- a/website/docs/migrating-from-v1-to-v2.md
+++ b/website/docs/migrating-from-v1-to-v2.md
@@ -329,11 +329,11 @@ module.exports = {
 The following fields are all deprecated, you may remove from your configuration file.
 
 - `blogSidebarTitle`
-- `cleanUrl`
-- `defaultVersionShown`
+- `cleanUrl` - Clean URL is used by default now.
+- `defaultVersionShown` - Versioning is not ported yet. You'd be unable to migration to Docusaurus 2 if you are using versioning. Stay tuned.
 - `disableHeaderTitle`
 - `disableTitleTagline`
-- `docsSideNavCollapsible`
+- `docsSideNavCollapsible` - This is turned on by default now.
 - `facebookAppId`
 - `facebookComments`
 - `facebookPixelId`
@@ -341,12 +341,12 @@ The following fields are all deprecated, you may remove from your configuration
 - `highlight` - We now use [Prism](https://prismjs.com/) instead of [highlight.js](https://highlightjs.org/).
 - `markdownOptions` - We use MDX in v2 instead of Remarkable. Your markdown options have to be converted to Remark/Rehype plugins.
 - `markdownPlugins` - We use MDX in v2 instead of Remarkable. Your markdown plugins have to be converted to Remark/Rehype plugins.
+- `manifest`
+- `noIndex`
+- `onPageNav` - This is turned on by default now.
 - `separateCss` - It can imported in the same manner as `custom.css` mentioned above.
 - `scrollToTop`
 - `scrollToTopOptions`
-- `manifest`
-- `noIndex`
-- `onPageNav`
 - `translationRecruitingLink`
 - `twitter`
 - `twitterUsername`