Update changelog, readme, what's new page and manifest for v0.5.0 (#172)

david-tejada · Aug 7, 2023 · 7e5ccf8 · 7e5ccf8
1 parent c14be09
commit 7e5ccf8
Show file tree

Hide file tree

Showing 6 changed files with 151 additions and 72 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,7 +2,46 @@
 
 All notable changes to the Rango extension will be documented in this file.
 
-## [0.4.2](https://github.com/david-tejada/rango/releases/tag/v0.4.2) - 2023-04-28
+## [0.5.0](https://github.com/david-tejada/rango/releases/tag/v0.5.0) - 2023-08-06
+
+### Changed
+
+- Improve the behavior of commands that place the cursor within or manipulate input text.
+- Only show "What's New" page for major or minor version updates, not patch updates.
+- Improvements to toast notifications.
+- Improve performance when refreshing hints.
+- Improve accessibility of hints (changing the hint size limit from 16px to 72px).
+- Improve accessibility of the settings page.
+
+### Added
+
+- Add keyboard shortcut to enable hints.
+- Add command `go input` to focus the first input found on the page.
+- Implement tab markers and the ability to focus tabs using them.
+- Add additional info to the settings page.
+- Add setting for deciding where to open new tabs.
+- Add settings to decide when to perform direct clicking.
+- Add setting for notifications duration.
+- Create keyboard clicking context menu in the browser action button.
+- Create onboarding page that shows up on install.
+
+### Fixed
+
+- Fix hints appearance being affected by `letter-spacing` of a parent element.
+- Fix tooltip not working properly on some pages.
+- Fix hints marked for inclusion or exclusion not being cleared after `hints refresh`.
+- Fix `custom hints reset` not clearing hints marked for inclusion or exclusion.
+- Fix `tab back` sometimes failing.
+- Fix custom selectors not working in iframes.
+- Fix keyboard clicking failing in some situations.
+- Fix wrongly positioned hint for some `contenteditable` elements.
+- Fix some hints being partially hidden in OneNote.
+- Fix hint not displaying properly with inherited `text-indent`.
+- Fix performance issue when calculating if a hintable is redundant.
+- Fix wrong stacking context of hints in some situations.
+- Fix an issue reclaiming hints from other frames that would cause not all hints to be shown when using `hint extra`.
+
+## [0.4.2](https://github.com/david-tejada/rango/releases/tag/v0.4.2) - 2023-04-
 
 ### Fixed
 

diff --git a/readme.md b/readme.md
@@ -276,6 +276,13 @@ half down <user.rango_target>:
 - `tab close previous [<number>]`: Closes the amount of tabs specified (or one if no number is given) to the left of the current tab.
 - `tab close next [<number>]`: Closes the amount of tabs specified (or one if no number is given) to the right of the current tab.
 
+#### Focus Tabs Using Tab Markers
+
+If you have the setting `Include tab markers in title` enabled (default) you can refer to those markers to quickly focus a specific tab.
+
+- `(go tab | slot) <marker>`: Focus the tab with the specified tab marker.
+- `tab marker refresh`: Refreshes the tab markers for the existing tabs. Note that this command will refresh all unloaded tabs as otherwise we are unable to change the tab markers.
+
 ### Modify Hints Size
 
 - `hint bigger`: Increase the size of the hints.
@@ -307,6 +314,49 @@ half down <user.rango_target>:
 
 - There is currently no way to open a pure CSS dropdown menu like the "hover" menu in [this example](https://www.tailwindtoolbox.com/components/megamenu-demo.php#). It is not possible to activate the `:hover` pseudo class in javascript and this will only be possible once I implement cursor moving/clicking.
 
+### No Hints or Other Missing Functionality in Certain Pages
+
+Content scripts (the part of the extension that runs in the context of webpages) aren't unable to run in browser's internal pages. These pages start with `chrome://`, `edge://`, `about:` or similar and provide information and control over browsers internal state, including settings, flags, and debugging information. Allowing content scripts on these pages could enable malicious extensions to change settings or access sensitive data without the user's knowledge. For this reason hints an other functionality won't be available in these pages.
+
+Similarly, there are other domains where content scripts are not allowed to run.
+
+These are restricted Chromium domains:
+
+```
+clients.google.com
+clients[0-9]+.google.com
+sb-ssl.google.com
+chrome.google.com/webstore/*
+```
+
+These are restricted Firefox domains:
+
+```
+accounts-static.cdn.mozilla.net
+accounts.firefox.com
+addons.cdn.mozilla.net
+addons.mozilla.org
+api.accounts.firefox.com
+content.cdn.mozilla.net
+discovery.addons.mozilla.org
+install.mozilla.org
+oauth.accounts.firefox.com
+profile.accounts.firefox.com
+support.mozilla.org
+sync.services.mozilla.com
+```
+
+To allow WebExtensions in Firefox to run on these pages (at your own risk), open `about:config` and modify the following[^3]:
+
+Set extensions.webextensions.restrictedDomains to be an empty string.4
+Set privacy.resistFingerprinting.block_mozAddonManager to true5
+Firefox 60 - Firefox 70: must be manually created by right-clicking and selecting New > Boolean3
+Firefox 71 and later6: paste preference name in search bar > in 2nd column set Boolean from single-choice list > click ➕ button in 3rd column.
+
+Another alternative is to use a Chromium browser to access Firefox restricted domains and Firefox to access Chromium restricted domains.
+
+[^3]: https://www.ghacks.net/2017/10/27/how-to-enable-firefox-webextensions-on-mozilla-websites/
+
 ## Contributing
 
 See the [Contributing guide](CONTRIBUTING.md).
diff --git a/src/mv2-safari/manifest.json b/src/mv2-safari/manifest.json
@@ -1,6 +1,6 @@
 {
 	"name": "Rango",
-	"version": "0.4.2",
+	"version": "0.5.0",
 	"description": "Extension that allows you to interact with webpages and the browser using only your keyboard or your voice and talon",
 	"homepage_url": "https://github.com/david-tejada/rango",
 	"manifest_version": 2,

diff --git a/src/mv2/manifest.json b/src/mv2/manifest.json
@@ -1,6 +1,6 @@
 {
 	"name": "Rango",
-	"version": "0.4.2",
+	"version": "0.5.0",
 	"description": "Extension that allows you to interact with webpages and the browser using your voice and talon or your keyboard",
 	"homepage_url": "https://github.com/david-tejada/rango",
 	"manifest_version": 2,

diff --git a/src/mv3/manifest.json b/src/mv3/manifest.json
@@ -1,6 +1,6 @@
 {
 	"name": "Rango",
-	"version": "0.4.2",
+	"version": "0.5.0",
 	"description": "Extension that allows you to interact with webpages and the browser using your voice and talon or your keyboard",
 	"homepage_url": "https://github.com/david-tejada/rango",
 	"manifest_version": 3,

diff --git a/src/pages/whatsNew/index.html b/src/pages/whatsNew/index.html
@@ -19,19 +19,20 @@
 	</head>
 	<body>
 		<div class="container">
-			<h1>Rango has been updated to version 0.4.2</h1>
+			<h1>Rango has been updated to version 0.5.0</h1>
 			<section>
 				<h2>What's new?</h2>
 				<p>
-					Hello, my dear friends! I have been hard at work to bring you all a
-					couple of highly requested features:
-					<strong>settings page</strong> and <strong>notifications</strong>.
-					With the setting page you can now change things like the font used for
-					the hints, the opacity, whether to use lower or upper case and more.
-					You can open the setting page with the command
-					<code>rango settings</code>. Toast notifications give you much needed
-					feedback when using commands like <code>copy page address</code> or
-					when toggling the hints.
+					Hello, my dear friends! I have been hard at work to bring you all some
+					goodies to make your web browsing life a bit easier. This release
+					brings us <strong>tab markers</strong> to be able to switch tabs much
+					more easily. Speaking about tabs, we have a new setting to allow you
+					to decide where new tabs should be opened: next to the opener tab or
+					at the end of the tab strip. And if you use tree style tabs now they
+					will be neatly arranged. We also have a new command
+					<code>go input</code> that allows you to focus the first input found
+					on the page. Besides that this release brings more improvements and
+					bug fixes.
 				</p>
 			</section>
 			<section>
@@ -59,97 +60,86 @@ <h2>Become a sponsor</h2>
 				>
 			</section>
 			<section>
-				<h2>Changelog for v0.4.2</h2>
-				<h4>Fixed</h4>
+				<h2>Changelog for v0.5.0</h2>
+				<h4>Changed</h4>
+
 				<ul>
 					<li>
-						Fix bug introduced in v0.4.1 where no command is able to run if
-						there is no content script.
+						Improve the behavior of commands that place the cursor within or
+						manipulate input text.
 					</li>
-				</ul>
-			</section>
-			<section>
-				<h2>Changelog for v0.4.1</h2>
-				<h4>Fixed</h4>
-				<ul>
 					<li>
-						Fix hints toggle status displaying without using any of the hint
-						toggle commands.
+						Only show "What's New" page for major or minor version updates, not
+						patch updates.
 					</li>
-				</ul>
-			</section>
-			<section>
-				<h2>Changelog for v0.4.0</h2>
-				<h4>Changed</h4>
-				<ul>
+					<li>Improvements to toast notifications.</li>
+					<li>Improve performance when refreshing hints.</li>
 					<li>
-						Use sync storage to keep settings synchronized across computers.
+						Improve accessibility of hints (changing the hint size limit from
+						16px to 72px).
 					</li>
+					<li>Improve accessibility of the settings page.</li>
 				</ul>
+
 				<h4>Added</h4>
+
 				<ul>
-					<li>Add toast notifications to provide better user feedback.</li>
-					<li>
-						Create a settings page to enable users to manage their preferences.
-					</li>
+					<li>Add keyboard shortcut to enable hints.</li>
 					<li>
-						Add command <code>rango settings</code> to open the setting page.
+						Add command <code>go input</code> to focus the first input found on
+						the page.
 					</li>
 					<li>
-						Add command <code>rango open {page}</code> to quickly open some
-						pages related to Rango like the readme, issues, new issue or
-						sponsors.
+						Implement tab markers and the ability to focus tabs using them. Use
+						<code>(go tab | slot) &lt;marker&gt;</code> for this.
 					</li>
+					<li>Add additional info to the settings page.</li>
+					<li>Add setting for deciding where to open new tabs.</li>
+					<li>Add settings to decide when to perform direct clicking.</li>
+					<li>Add setting for notifications duration.</li>
 					<li>
-						Add page What's New to show the user the new features and changes
-						when the extension updates.
+						Create keyboard clicking context menu in the browser action button.
 					</li>
+					<li>Create onboarding page that shows up on install.</li>
 				</ul>
-				<h4>Removed</h4>
+
+				<h4>Fixed</h4>
+
 				<ul>
 					<li>
-						Remove commands for changing the hint weight and style (boxed or
-						subtle) as this can be now accomplished using the settings page.
+						Fix hints appearance being affected by
+						<code>letter-spacing</code> of a parent element.
 					</li>
-				</ul>
-				<h4>Fixed</h4>
-				<ul>
+					<li>Fix tooltip not working properly on some pages.</li>
 					<li>
-						Fix hints sometimes not reacting to commands after navigating back
-						or forward in the page history.
+						Fix hints marked for inclusion or exclusion not being cleared after
+						`hints refresh`.
 					</li>
 					<li>
-						Fix allocation of hints in Safari when the user has the option
-						"Preload Top Hit in the background" enabled.
+						Fix `custom hints reset` not clearing hints marked for inclusion or
+						exclusion.
 					</li>
+					<li>Fix <code>tab back</code> sometimes failing.</li>
+					<li>Fix custom selectors not working in iframes.</li>
+					<li>Fix keyboard clicking failing in some situations.</li>
 					<li>
-						Fix some checkboxes and toggle buttons not receiving hints,
-						considering cases where the input/button element is hidden and
-						replaced with a stylized sibling.
+						Fix wrongly positioned hint for some
+						<code>contenteditable</code> elements.
 					</li>
-					<li>Handle cases where hints are deleted by the page.</li>
+					<li>Fix some hints being partially hidden in OneNote.</li>
 					<li>
-						Fix scrolling behavior to ensure the correct scroll amount in
-						various pages. Issue #94.
+						Fix hint not displaying properly with inherited
+						<code>text-indent</code>.
 					</li>
 					<li>
-						Fix issue with hints modifying the aspect of tables with
-						<code>table-layout: fixed</code>. Issue #92.
+						Fix performance issue when calculating if a hintable is redundant.
 					</li>
-					<li>Fix keyboard clicking not working in iframes.</li>
-					<li>Fix tooltip not always displaying correctly.</li>
+					<li>Fix wrong stacking context of hints in some situations.</li>
 					<li>
-						Fix some editable elements not receiving focus when clicked or
-						having the cursor placed in the wrong position when using the
-						<code>post</code>
-						command.
+						Fix an issue reclaiming hints from other frames that would cause not
+						all hints to be shown when using <code>hint extra</code>.
 					</li>
 				</ul>
-				<a
-					href="https://github.com/david-tejada/rango/blob/main/CHANGELOG.md"
-					target="_blank"
-					>View the entire changelog</a
-				>
 			</section>
 		</div>
 	</body>