Skip to content

docs(windows): update kb0076 to include log capturing on firefox#2569

Open
Meng-Heng wants to merge 3 commits into
masterfrom
docs/update-kb-0076
Open

docs(windows): update kb0076 to include log capturing on firefox#2569
Meng-Heng wants to merge 3 commits into
masterfrom
docs/update-kb-0076

Conversation

@Meng-Heng

@Meng-Heng Meng-Heng commented Jun 15, 2026

Copy link
Copy Markdown
Collaborator

Sources

  1. https://community.software.sil.org/t/backspace-problems-with-keyman-keyboard-in-a-google-doc-in-firefox/9664/18
  2. https://community.software.sil.org/t/backspace-and-search-bars-acting-weird-on-firefox/10870/27

Context

I found two topics that have the instruction to capture logs in Firefox. Would this fit in the knowledge base?

This PR is adding Capture a log in Firefox, changing the title to include Firefox, and updating syntaxes for Warning and Note.

This is ready for review.
Test-bot: skip

@Meng-Heng Meng-Heng added this to the A19S31 milestone Jun 15, 2026
@Meng-Heng Meng-Heng requested a review from rc-swag June 15, 2026 07:35
@github-actions github-actions Bot added the docs label Jun 15, 2026
@github-project-automation github-project-automation Bot moved this to Todo in Keyman Jun 15, 2026
@keymanapp-test-bot

Copy link
Copy Markdown

User Test Results

Test specification and instructions

User tests are not required

@Meng-Heng Meng-Heng changed the title docs: update kb0076 to include log capturing on firefox docs(windows): update kb0076 to include log capturing on firefox Jun 15, 2026
@Meng-Heng Meng-Heng marked this pull request as ready for review June 15, 2026 07:36
Comment thread knowledge-base/kb0076.md
@@ -1,9 +1,9 @@
# HOWTO: Run Debugging in Keyman Desktop
# HOWTO: Run Debugging in Keyman Desktop and Firefox

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we should change it to "Keyman for Windows" instead of "Keyman Desktop" (throughout this doc).

Suggested change
# HOWTO: Run Debugging in Keyman Desktop and Firefox
# HOWTO: Run Debugging in Keyman for Windows and Firefox

Comment thread knowledge-base/kb0076.md
**NOTE**: Please only perform send Keyman Support a log file if we request it. We don't have the resources to review unsolicited log files!
## Capture a log in Firefox

#### Only follow this if the issue is related to Google products or other web applications.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I find this sentence confusing. Why the focus on Google products? Shouldn't I follow these steps if I have problems typing on a normal website? And in general, when should I not follow these steps?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes I think remove this sentance or it should just say

"These steps are for issues you have that are reproducilbe using Firefox"

MengHeng the main times I have asked for this debug capture in the forums is when users have had problems using Firefox and Googe Docs/Sheets. However, I also used it for just contentedable fields in Firefox (so general web pages really).

It is most usefull for finding issues with Firefox. However it could be usefull if there is a particullar webpage/application that doesn't work with Keyman and any browser and you could use Firefox just for its abillity to capture a log.

Comment thread knowledge-base/kb0076.md

#### Only follow this if the issue is related to Google products or other web applications.

1) Open a testcase in a tab, e.g. Google Docs or Sheets

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1) Open a testcase in a tab, e.g. Google Docs or Sheets
1) Open a testcase in a tab, e.g. Google Docs or Sheets, Website with issue

@rc-swag rc-swag left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a few suggestions

Comment thread knowledge-base/kb0076.md

5) If you see “Start logging” button in top of the page, click it.

6) Back to the tab loaded the testcase with mouse

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
6) Back to the tab loaded the testcase with mouse
6) Go back to the tab loaded with the testcase using the mouse

Comment thread knowledge-base/kb0076.md

6) Back to the tab loaded the testcase with mouse

7) Click the editor and do the minimum steps to reproduce the bug

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
7) Click the editor and do the minimum steps to reproduce the bug
7) Do the minimum steps to reproduce the bug

Comment thread knowledge-base/kb0076.md

7) Click the editor and do the minimum steps to reproduce the bug

8) Back to the tab loaded `about:logging` with mouse

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
8) Back to the tab loaded `about:logging` with mouse
8) Go back to the tab loaded `about:logging` with mouse

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

4 participants