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 3 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

You can create an Office Add-in by using the Office Add-ins Development Kit or the Yeoman generator in Visual Studio Code. Select the tab for the one you'd like to use and then follow the instructions to create your add-in and test it locally.

# [Office Add-ins Development Kit](#tab/devkit)
## Prerequisites
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 prerequisite section is same as the one section in (docs/develop/development-kit-overview.md)

> [!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).

## Explore the project
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 "Explore the project"section is most similar as the one in the yeoman option.

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)


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?

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.

1 participant