TDX Knowledge: Enhance Article Content

This supplementary guide is for TeamDynamix (TDX) agents who manage knowledge articles, helping them enhance the effectiveness of their content.

This knowledge article provides guidance for TeamDynamix (TDX) Knowledge Contributors on how to add a table of contents (TOC), insert images, and improve the overall readability of their articles.

 

In This Article:

• Adding Table of Content
• Inserting Images 
  • Add Block Images
  • Add Inline Images
  • Change Image Settings
• Checking Content Readability
• Improving Content with Copilot

 

Adding Table of Content

You can create a Table of Content (TOC) using in-page anchor links.

Step 1: Mark Anchors 

Assuming you are already editing the article:

1. Locate the text you want to create an anchor for.
2. Place the cursor to the left of the text (do not highlight the text).
3. Click the Anchor button.

4. Enter the name of the anchor and click Ok.

 

Steps 2: Link Anchors

1. Select the text you want to hyperlink, pointing to the marked anchor.
2. Click the Link button.
3. In the Link Type drop-down menu, select Link to anchor in the text.

4. In the By Anchor Name drop-down menu, select the desired anchor text.
5. Click Ok.

 

Inserting Images

Do not copy and paste images, as they may disappear intermittently. Always insert images properly.

Add Block Images

Assuming you are already editing the article:

1. Go to the end of the step/sentence you wish to add an image after.
2. Press Shift + Enter (Mac: Shift + Return) to insert a new line break. 
3. Select the Image icon
4. Select the Upload tab.
5. Click Choose File.
   
6. Click Send it to the Server.
7. Go to the Image Info tab and enter appropriate Alternative Text. 
8. Be sure the Lock Ratio padlock is locked before re-sizing the image.   
9. Set the Border to 1 (unless the edges are already well-defined).
10. Click OK

 

Add Inline Images

Assuming you are already editing the article:

1. Click where you wish to add an image.
2. Select the Image icon.
3. Select the Upload tab and click Choose File.

4. Click Send it to the Server.
5. Go to the Image Info tab.
6. Be sure the Lock Ratio padlock is locked before re-sizing the image.   
7. Click OK
8. Double-click the image to open the Image Properties window.
9. Go to the Advanced tab

10. In the Style field, enter ;display:inline; at the end of the existing text.
11. Click OK

 

Change Image Settings

• Double-click the image to open the Image Properties window to make any changes.

 

Checking Content Readability

1. Open Microsoft Word.
2. Copy the article content from TDX and paste it into to a Word document.

3. On the Ribbon menu, click Review.
4. Click Editor. A sidebar will open showing various characteristics of the text.
5. Scroll down to Insights and click Document Stats.
6. If a confirmation pop-up appears, click OK. The readability statistics pop-up will display your content's readability scores.

 

Improving Content with Gen-AI

You can use Gen-AI (e.g. ChatGPT, Grok, Copilot) to improve your existing text draft.

1. Create article draft in TDX. 
2. Access the Gen-AI tool of your choice.
3. In the Gen-AI's chat prompt, paste the following instruction set.

Treat this chat absolutely independently and do not use context from other chats. You are an expert Knowledge Base Specialist. Revise the article content to enhance clarity, structure, and consistency. Correct grammatical errors, improve sentence flow, and ensure smooth transitions between ideas. Replace passive voice with active voice where applicable and correct any subject-verb agreement issues. Remove redundancy while preserving all essential information, ensuring the content remains concise, clear, coherent, and professional. Adjust the language to maintain a readability level appropriate for a 9th-grade audience based on the Flesch-Kincaid scale. Ensure all website hyperlinks are masked behind their target page titles to enhance readability and accessibility:

4. Paste the article draft contents right after the instruction set text.
5. Submit your prompt for processing. 
6. Review the Gen-AI-generated draft and modify /rerun as needed.
7. Copy the refined content

8. Use the ‘Paste as plain text’ feature to transfer the content into the TDX article body.
9. Format the pasted content as needed in TDX.
10. Save or submit the article like you normally do.

 

---