Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update the W/X quickstart articles when the Dev Kit GA #4902

Open
wants to merge 20 commits into
base: main
Choose a base branch
from

Conversation

MingjiaLiu1995
Copy link
Contributor

  1. Add the Dev Kit option in the Excel quickstart article.
  2. Add the Dev Kit option in the Word quickstart article.

The articles when NOT be published until the Dev Kit is ready for GA.

Copy link
Contributor

Learn Build status updates of commit f1761ba:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/quickstarts/excel-quickstart-jquery.md ⚠️Warning View Details
docs/quickstarts/word-quickstart-yo.md ⚠️Warning View Details
docs/images/office-add-ins-development-kit-samplepage-excelquickstart.png ✅Succeeded View
docs/images/office-add-ins-development-kit-samplepage-wordquickstart.png ✅Succeeded View

docs/quickstarts/excel-quickstart-jquery.md

  • Line 35, Column 113: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 35, Column 113: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' will be broken in isolated environments. Replace with a relative link.

docs/quickstarts/word-quickstart-yo.md

  • Line 35, Column 113: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 35, Column 113: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' will be broken in isolated environments. Replace with a relative link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

Copy link
Contributor Author

@MingjiaLiu1995 MingjiaLiu1995 left a comment

Choose a reason for hiding this comment

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

Hi @AlexJerabek , I start a initial proposal on the documentation update to prepare for the Dev Kit GA. Please feel free to let me know your thoughts! Thanks ;)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

The snapshoots are now placeholders. Need to update with the new sample naming

docs/quickstarts/excel-quickstart-jquery.md Show resolved Hide resolved
docs/quickstarts/excel-quickstart-jquery.md Show resolved Hide resolved
1. The ./src/taskpane/taskpane.css file contains the CSS that's applied to content in the task pane.
1. The ./src/taskpane/taskpane.js file contains the Office JavaScript API code that facilitates interaction between the task pane and the Office client application.

## Try it out
Copy link
Contributor Author

Choose a reason for hiding this comment

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

"Try it out", "Stop testing", "Troubleshooting" are same as the ones in (docs/develop/development-kit-overview.md)

Copy link
Collaborator

Choose a reason for hiding this comment

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

Same suggestion for an include file. This prevents content from being different in two places if we miss something in an update.

Copy link
Collaborator

Choose a reason for hiding this comment

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

Is there a reason we didn't include the headers in the include files? I think you could make this whole thing one include file.


Click the following button to create an add-in project using the Office Add-ins Development Kit for Visual Studio Code. A page that contains the project decription will open in Visual Studio Code.

<button type="button">[Create an add-in in Visual Studio Code](vscode://msoffice.microsoft-office-add-in-debugger/open-specific-sample?sample-id=Excel-HelloWorld-TaskPane-JS)</button>
Copy link
Contributor Author

Choose a reason for hiding this comment

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

I imagine a clickable button to link to the sample page in VSC. Can we achieve that in MS Learn site?

Copy link
Collaborator

Choose a reason for hiding this comment

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

I think this is the best way to do that: https://review.learn.microsoft.com/en-us/help/platform/markdown-reference?branch=main#next-step-action. I've added the markdown as a suggestion.

docs/quickstarts/excel-quickstart-jquery.md Outdated Show resolved Hide resolved
docs/quickstarts/excel-quickstart-jquery.md Outdated Show resolved Hide resolved

Click the following button to create an add-in project using the Office Add-ins Development Kit for Visual Studio Code. A page that contains the project decription will open in Visual Studio Code.

<button type="button">[Create an add-in in Visual Studio Code](vscode://msoffice.microsoft-office-add-in-debugger/open-specific-sample?sample-id=Excel-HelloWorld-TaskPane-JS)</button>
Copy link
Collaborator

Choose a reason for hiding this comment

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

I think this is the best way to do that: https://review.learn.microsoft.com/en-us/help/platform/markdown-reference?branch=main#next-step-action. I've added the markdown as a suggestion.

Comment on lines 28 to 30
<img src="../images/office-add-ins-development-kit-samplepage-excelquickstart.png" alt="Screenshot shows the sample page in Visual Studio Code"/>

In the prompted page, select **Create** to create the add-in project. In the **Workspace folder** dialog that opens, select the folder where you want to create the project.
Copy link
Collaborator

Choose a reason for hiding this comment

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

I'd move the screenshot so it follow the "Create" instruction. In the screenshot, surround the Create button with a red box to highlight where it is in the UI.

docs/quickstarts/excel-quickstart-jquery.md Outdated Show resolved Hide resolved
docs/quickstarts/word-quickstart-yo.md Outdated Show resolved Hide resolved
docs/quickstarts/word-quickstart-yo.md Outdated Show resolved Hide resolved

<button type="button">[Create an add-in in Visual Studio Code](vscode://msoffice.microsoft-office-add-in-debugger/open-specific-sample?sample-id=Word-HelloWorld-TaskPane-JS)</button>

<img src="../images/office-add-ins-development-kit-samplepage-wordquickstart.png" alt="Screenshot shows the sample page in Visual Studio Code"/>
Copy link
Collaborator

Choose a reason for hiding this comment

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

Same suggestion as with Excel for a different screenshot.

docs/quickstarts/word-quickstart-yo.md Outdated Show resolved Hide resolved
docs/quickstarts/word-quickstart-yo.md Outdated Show resolved Hide resolved
@AlexJerabek
Copy link
Collaborator

Thanks for putting this together @MingjiaLiu1995! When are we planning to launch the Dev Kit for GA?

@MingjiaLiu1995
Copy link
Contributor Author

Thanks for putting this together @MingjiaLiu1995! When are we planning to launch the Dev Kit for GA?

Thanks for the review comments Alex!

The only GA dependency is completing merging all the existing samples. Herman submitted the last sample repo today(Thursday), so I guess we can target some day in the next 1~2 weeks if there is no other concern?

Btw, who would be the dev kit contact during your oof? I'll address all these comments tomorrow(Friday), so hopefully only small adjustment and review are needed after. (And wish you have a great vacation!)

Copy link
Contributor

Learn Build status updates of commit 0151746:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/quickstarts/excel-quickstart-jquery.md ⚠️Warning View Details
docs/quickstarts/word-quickstart-yo.md ⚠️Warning View Details
docs/images/office-add-ins-development-kit-samplepage-excelquickstart.png ✅Succeeded View
docs/images/office-add-ins-development-kit-samplepage-wordquickstart.png ✅Succeeded View

docs/quickstarts/excel-quickstart-jquery.md

  • Line 35, Column 113: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 35, Column 113: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' will be broken in isolated environments. Replace with a relative link.

docs/quickstarts/word-quickstart-yo.md

  • Line 35, Column 113: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 35, Column 113: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' will be broken in isolated environments. Replace with a relative link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

Copy link
Contributor

Learn Build status updates of commit 9468361:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/quickstarts/excel-quickstart-jquery.md ⚠️Warning View Details
docs/quickstarts/word-quickstart-yo.md ⚠️Warning View Details
docs/images/office-add-ins-development-kit-samplepage-excelquickstart.png ✅Succeeded View
docs/images/office-add-ins-development-kit-samplepage-wordquickstart.png ✅Succeeded View

docs/quickstarts/excel-quickstart-jquery.md

  • Line 33, Column 113: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 33, Column 113: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' will be broken in isolated environments. Replace with a relative link.

docs/quickstarts/word-quickstart-yo.md

  • Line 35, Column 113: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 35, Column 113: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' will be broken in isolated environments. Replace with a relative link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

Copy link
Contributor

Learn Build status updates of commit 4d2e785:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/quickstarts/excel-quickstart-jquery.md ⚠️Warning View Details
docs/quickstarts/word-quickstart-yo.md ⚠️Warning View Details
docs/images/office-add-ins-development-kit-samplepage-excelquickstart.png ✅Succeeded View
docs/images/office-add-ins-development-kit-samplepage-wordquickstart.png ✅Succeeded View

docs/quickstarts/excel-quickstart-jquery.md

  • Line 33, Column 113: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 33, Column 113: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' will be broken in isolated environments. Replace with a relative link.

docs/quickstarts/word-quickstart-yo.md

  • Line 35, Column 179: [Warning: file-not-found - See documentation] Invalid file link: '../development-kit-overview.md'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

Copy link
Contributor

Learn Build status updates of commit d540a61:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/quickstarts/excel-quickstart-jquery.md ⚠️Warning View Details
docs/quickstarts/word-quickstart-yo.md ⚠️Warning View Details
docs/images/office-add-ins-development-kit-samplepage-excelquickstart.png ✅Succeeded View
docs/images/office-add-ins-development-kit-samplepage-wordquickstart.png ✅Succeeded View

docs/quickstarts/excel-quickstart-jquery.md

  • Line 33, Column 113: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 33, Column 113: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' will be broken in isolated environments. Replace with a relative link.

docs/quickstarts/word-quickstart-yo.md

  • Line 35, Column 179: [Warning: file-not-found - See documentation] Invalid file link: '../development-kit-overview.md'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

Copy link
Contributor

Learn Build status updates of commit c935e3a:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/quickstarts/excel-quickstart-jquery.md ⚠️Warning View Details
docs/quickstarts/word-quickstart-yo.md ⚠️Warning View Details
docs/images/office-add-ins-development-kit-samplepage-excelquickstart.png ✅Succeeded View
docs/images/office-add-ins-development-kit-samplepage-wordquickstart.png ✅Succeeded View
docs/includes/devkit-prerequisites ✅Succeeded

docs/quickstarts/excel-quickstart-jquery.md

  • Line 33, Column 113: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 33, Column 113: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' will be broken in isolated environments. Replace with a relative link.

docs/quickstarts/word-quickstart-yo.md

  • Line 35, Column 179: [Warning: file-not-found - See documentation] Invalid file link: '../development-kit-overview.md'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

Copy link
Contributor

Learn Build status updates of commit baf9b8c:

❌ Validation status: errors

Please follow instructions here which may help to resolve issue.

File Status Preview URL Details
docs/quickstarts/excel-quickstart-jquery.md ❌Error Details
docs/quickstarts/word-quickstart-yo.md ⚠️Warning Details

docs/quickstarts/excel-quickstart-jquery.md

  • Line 16, Column 1: [Error: include-not-found - See documentation] Invalid include link: '../includes/devkit-prerequisites.md'.
  • Line 31, Column 113: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 31, Column 113: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' will be broken in isolated environments. Replace with a relative link.

docs/quickstarts/word-quickstart-yo.md

  • Line 35, Column 179: [Warning: file-not-found - See documentation] Invalid file link: '../development-kit-overview.md'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

Copy link
Contributor

Learn Build status updates of commit 9349148:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/quickstarts/excel-quickstart-jquery.md ⚠️Warning View Details
docs/quickstarts/word-quickstart-yo.md ⚠️Warning View Details
docs/images/office-add-ins-development-kit-samplepage-excelquickstart.png ✅Succeeded View
docs/images/office-add-ins-development-kit-samplepage-wordquickstart.png ✅Succeeded View
docs/includes/dev-kit-prerequisites ✅Succeeded

docs/quickstarts/excel-quickstart-jquery.md

  • Line 31, Column 113: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 31, Column 113: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' will be broken in isolated environments. Replace with a relative link.

docs/quickstarts/word-quickstart-yo.md

  • Line 35, Column 179: [Warning: file-not-found - See documentation] Invalid file link: '../development-kit-overview.md'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

Copy link
Contributor

Learn Build status updates of commit 2d1bf91:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/quickstarts/excel-quickstart-jquery.md ⚠️Warning View Details
docs/quickstarts/word-quickstart-yo.md ⚠️Warning View Details
docs/images/office-add-ins-development-kit-samplepage-excelquickstart.png ✅Succeeded View
docs/images/office-add-ins-development-kit-samplepage-wordquickstart.png ✅Succeeded View
docs/includes/dev-kit-prerequisites.md ✅Succeeded View

docs/quickstarts/excel-quickstart-jquery.md

  • Line 31, Column 113: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 31, Column 113: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' will be broken in isolated environments. Replace with a relative link.

docs/quickstarts/word-quickstart-yo.md

  • Line 35, Column 179: [Warning: file-not-found - See documentation] Invalid file link: '../development-kit-overview.md'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

Copy link
Contributor

Learn Build status updates of commit ecc441a:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/quickstarts/excel-quickstart-jquery.md ⚠️Warning View Details
docs/quickstarts/word-quickstart-yo.md ⚠️Warning View Details
docs/images/office-add-ins-development-kit-samplepage-excelquickstart.png ✅Succeeded View
docs/images/office-add-ins-development-kit-samplepage-wordquickstart.png ✅Succeeded View
docs/includes/dev-kit-prerequisites.md ✅Succeeded View

docs/quickstarts/excel-quickstart-jquery.md

  • Line 31, Column 113: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 31, Column 113: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' will be broken in isolated environments. Replace with a relative link.

docs/quickstarts/word-quickstart-yo.md

  • Line 35, Column 179: [Warning: file-not-found - See documentation] Invalid file link: '../development-kit-overview.md'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

Copy link
Contributor

Learn Build status updates of commit 53e225b:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/quickstarts/excel-quickstart-jquery.md ⚠️Warning View Details
docs/quickstarts/word-quickstart-yo.md ⚠️Warning View Details
docs/images/office-add-ins-development-kit-samplepage-excelquickstart.png ✅Succeeded View
docs/images/office-add-ins-development-kit-samplepage-wordquickstart.png ✅Succeeded View
docs/includes/dev-kit-prerequisites.md ✅Succeeded View

docs/quickstarts/excel-quickstart-jquery.md

  • Line 32, Column 113: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 32, Column 113: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' will be broken in isolated environments. Replace with a relative link.

docs/quickstarts/word-quickstart-yo.md

  • Line 33, Column 179: [Warning: file-not-found - See documentation] Invalid file link: '../development-kit-overview.md'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

Copy link
Contributor

Learn Build status updates of commit e09e338:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/quickstarts/excel-quickstart-jquery.md ⚠️Warning View Details
docs/quickstarts/word-quickstart-yo.md ⚠️Warning View Details
docs/images/office-add-ins-development-kit-samplepage-excelquickstart.png ✅Succeeded View
docs/images/office-add-ins-development-kit-samplepage-wordquickstart.png ✅Succeeded View
docs/includes/dev-kit-prerequisites.md ✅Succeeded View

docs/quickstarts/excel-quickstart-jquery.md

  • Line 32, Column 113: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 32, Column 113: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' will be broken in isolated environments. Replace with a relative link.

docs/quickstarts/word-quickstart-yo.md

  • Line 34, Column 179: [Warning: file-not-found - See documentation] Invalid file link: '../development-kit-overview.md'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

Copy link
Contributor

Learn Build status updates of commit 4f3ef68:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/quickstarts/excel-quickstart-jquery.md ⚠️Warning View Details
docs/quickstarts/word-quickstart-yo.md ⚠️Warning View Details
docs/develop/development-kit-overview.md ✅Succeeded View
docs/images/office-add-ins-development-kit-samplepage-excelquickstart.png ✅Succeeded View
docs/images/office-add-ins-development-kit-samplepage-wordquickstart.png ✅Succeeded View
docs/includes/dev-kit-prerequisites.md ✅Succeeded View
docs/includes/dev-kit-start-debugging.md ✅Succeeded View
docs/includes/dev-kit-stop-debugging.md ✅Succeeded View
docs/includes/dev-kit-troubleshooting.md ✅Succeeded View
docs/includes/devkit-project-components-taskpane.md ✅Succeeded View

docs/quickstarts/excel-quickstart-jquery.md

  • Line 32, Column 113: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 32, Column 113: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' will be broken in isolated environments. Replace with a relative link.

docs/quickstarts/word-quickstart-yo.md

  • Line 32, Column 179: [Warning: file-not-found - See documentation] Invalid file link: '../development-kit-overview.md'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

Copy link
Contributor

Learn Build status updates of commit f6e6f13:

⚠️ Validation status: warnings

File Status Preview URL Details
docs/quickstarts/excel-quickstart-jquery.md ⚠️Warning View Details
docs/quickstarts/word-quickstart-yo.md ⚠️Warning View Details
docs/develop/development-kit-overview.md ✅Succeeded View
docs/images/office-add-ins-development-kit-samplepage-excelquickstart.png ✅Succeeded View
docs/images/office-add-ins-development-kit-samplepage-wordquickstart.png ✅Succeeded View
docs/includes/dev-kit-prerequisites.md ✅Succeeded View
docs/includes/dev-kit-start-debugging.md ✅Succeeded View
docs/includes/dev-kit-stop-debugging.md ✅Succeeded View
docs/includes/dev-kit-troubleshooting.md ✅Succeeded View
docs/includes/devkit-project-components-taskpane.md ✅Succeeded View

docs/quickstarts/excel-quickstart-jquery.md

  • Line 32, Column 113: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 32, Column 113: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode' will be broken in isolated environments. Replace with a relative link.

docs/quickstarts/word-quickstart-yo.md

  • Line 32, Column 179: [Warning: file-not-found - See documentation] Invalid file link: '../development-kit-overview.md'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

For any questions, please:

@MingjiaLiu1995
Copy link
Contributor Author

@AlexJerabek I have addressed all the previous comments. Let me know if there are more. Thanks!

Office Add-ins Development Kit will create the project. It will then open the project *in a second Visual Studio Code window*. Close the original Visual Studio Code window.

> [!NOTE]
> You will receive prompts to install the Office Add-ins Development Kit extension if you haven't. You can also [install the Office Add-ins Development Kit manually](https://learn.microsoft.com/en-us/office/dev/add-ins/develop/development-kit-overview?tabs=vscode).
Copy link
Collaborator

Choose a reason for hiding this comment

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

@MingjiaLiu1995, looks like this comment was missed. That should resolve the build warnings (which needs to happen before this PR can be checked in)

Comment on lines +3 to +6
1. The ./manifest.xml or manifest.json file in the root directory of the project defines the settings and capabilities of the add-in.
1. The ./src/taskpane/taskpane.html file contains the HTML markup for the task pane.
1. The ./src/taskpane/taskpane.css file contains the CSS that's applied to content in the task pane.
1. The ./src/taskpane/taskpane.js file contains the Office JavaScript API code that facilitates interaction between the task pane and the Office client application.
Copy link
Collaborator

Choose a reason for hiding this comment

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

File names should be in bold

Suggested change
1. The ./manifest.xml or manifest.json file in the root directory of the project defines the settings and capabilities of the add-in.
1. The ./src/taskpane/taskpane.html file contains the HTML markup for the task pane.
1. The ./src/taskpane/taskpane.css file contains the CSS that's applied to content in the task pane.
1. The ./src/taskpane/taskpane.js file contains the Office JavaScript API code that facilitates interaction between the task pane and the Office client application.
1. The **./manifest.xml** or **./manifest.json** file in the root directory of the project defines the settings and capabilities of the add-in.
1. The **./src/taskpane/taskpane.html** file contains the HTML markup for the task pane.
1. The **./src/taskpane/taskpane.css** file contains the CSS that's applied to content in the task pane.
1. The **./src/taskpane/taskpane.js** file contains the Office JavaScript API code that facilitates interaction between the task pane and the Office client application.


In the prompted page, select **Create** to create the add-in project. In the **Workspace folder** dialog that opens, select the folder where you want to create the project.

<img src="../images/office-add-ins-development-kit-samplepage-excelquickstart.png" alt="Screenshot shows the sample page in Visual Studio Code"/>
Copy link
Collaborator

Choose a reason for hiding this comment

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

Favor the Learn image markdown syntax

Suggested change
<img src="../images/office-add-ins-development-kit-samplepage-excelquickstart.png" alt="Screenshot shows the sample page in Visual Studio Code"/>
:::image type="content" source="../images/office-add-ins-development-kit-samplepage-excelquickstart.png" alt-text="The Development Kit sample gallery in Visual Studio Code":::

1. The ./src/taskpane/taskpane.css file contains the CSS that's applied to content in the task pane.
1. The ./src/taskpane/taskpane.js file contains the Office JavaScript API code that facilitates interaction between the task pane and the Office client application.

## Try it out
Copy link
Collaborator

Choose a reason for hiding this comment

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

Is there a reason we didn't include the headers in the include files? I think you could make this whole thing one include file.

Comment on lines +49 to +50


Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change

Comment on lines +49 to +50


Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change


In the prompted page, select **Create** to create the add-in project. In the **Workspace folder** dialog that opens, select the folder where you want to create the project.

<img src="../images/office-add-ins-development-kit-samplepage-wordquickstart.png" alt="Screenshot shows the sample page in Visual Studio Code"/>
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
<img src="../images/office-add-ins-development-kit-samplepage-wordquickstart.png" alt="Screenshot shows the sample page in Visual Studio Code"/>
:::image type="content" source="../images/office-add-ins-development-kit-samplepage-wordquickstart.png" alt-text="The Development Kit sample gallery in Visual Studio Code":::

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants