Merge pull request #757 from OfficeDev/main

[admin] Publish

Author: alison-mk

Contributing.md

@@ -61,7 +61,7 @@ Pull requests are typically reviewed within 10 business days.
 
 ## Use GitHub, Git, and this repository
 
-**Note**: Most of the information in this section can be found in [GitHub Help] articles.  If you're familiar with Git and GitHub, skip to the **Contribute and edit content** section for the specifics of the code/content flow of this repository.
+**Note**: Most of the information in this section can be found in [GitHub Help] articles.  If you're familiar with Git and GitHub, skip to the **Contribute and edit content** section for the specifics of the code and content flow of this repository.
 
 ### To set up your fork of the repository
 
@@ -70,12 +70,12 @@ Pull requests are typically reviewed within 10 business days.
 3. Create your own fork of this repository. To do this, at the top of the page,  choose the **Fork** button.
 4. Copy your fork to your computer. To do this, open Git Bash. At the command prompt enter:
 
-        git clone https://github.com/<your user name>/<repo name>.git
+        git clone https://github.com/<your username>/office-scripts-docs.git
 
     Next, create a reference to the root repository by entering these commands:
 
         cd <repo name>
-        git remote add upstream https://github.com/OfficeDev/<repo name>.git
+        git remote add upstream https://github.com/OfficeDev/office-scripts-docs.git
         git fetch upstream
 
 Congratulations! You've now set up your repository. You won't need to repeat these steps again.
@@ -91,7 +91,7 @@ To make the contribution process as seamless as possible, follow these steps.
 3. Submit a pull request to the main repository.
 4. Delete the branch.
 
-**Important** Limit each branch to a single concept/article to streamline the work flow and reduce the chance of merge conflicts. Content appropriate for a new branch includes:
+**Important** Limit each branch to a single concept or article to streamline the workflow and reduce the chance of merge conflicts. Content appropriate for a new branch includes:
 
 * A new article.
 * Spelling and grammar edits.
@@ -100,17 +100,17 @@ To make the contribution process as seamless as possible, follow these steps.
 #### To create a new branch
 
 1. Open Git Bash.
-2. At the Git Bash command prompt, type `git pull upstream master:<new branch name>`. This creates a new branch locally that is copied from the latest OfficeDev master branch.
+2. At the Git Bash command prompt, type `git pull upstream main:<new branch name>`. This creates a new branch locally that is copied from the latest OfficeDev/office-scripts-docs main branch.
 3. At the Git Bash command prompt, type `git push origin <new branch name>`. This alerts GitHub to the new branch. You should now see the new branch in your fork of the repository on GitHub.
 4. At the Git Bash command prompt, type `git checkout <new branch name>` to switch to your new branch.
 
 #### Add new content or edit existing content
 
-You navigate to the repository on your computer by using File Explorer. The repository files are in `C:\Users\<yourusername>\<repo name>`.
+You navigate to the repository on your computer by using File Explorer. The repository files are in `C:\Users\<your username>\office-scripts-docs`.
 
 To edit files, open them in an editor of your choice and modify them. To create a new file, use the editor of your choice and save the new file in the appropriate location in your local copy of the repository. While working, save your work frequently.
 
-The files in `C:\Users\<yourusername>\<repo name>` are a working copy of the new branch that you created in your local repository. Changing anything in this folder doesn't affect the local repository until you commit a change. To commit a change to the local repository, type the following commands in GitBash:
+The files in `C:\Users\<your username>\office-scripts-docs` are a working copy of the new branch that you created in your local repository. Changing anything in this folder doesn't affect the local repository until you commit a change. To commit a change to the local repository, type the following commands in Git Bash.
 
     git add .
     git commit -v -a -m "<Describe the changes made in this commit>"
@@ -130,38 +130,38 @@ When you're finished with your work and are ready to have it merged into the mai
 1. In the Git Bash command prompt, type `git push origin <new branch name>`. In your local repository, `origin` refers to your GitHub repository that you cloned the local repository from. This command pushes the current state of your new branch, including all commits made in the previous steps, to your GitHub fork.
 2. On the GitHub site, navigate in your fork to the new branch.
 3. Choose the **Pull Request** button at the top of the page.
-4. Verify the Base branch is `OfficeDev/<repo name>@master` and the Head branch is `<your username>/<repo name>@<branch name>`.
+4. Verify the Base branch is `OfficeDev/office-scripts-docs@main` and the Head branch is `<your username>/office-scripts-docs@<branch name>`.
 5. Choose the **Update Commit Range** button.
 6. Add a title to your pull request, and describe all the changes you're making.
 7. Submit the pull request.
 
-One of the site administrators will process your pull request. Your pull request will surface on the OfficeDev/<repo name> site under Issues. When the pull request is accepted, the issue will be resolved.
+One of the site administrators will process your pull request. Your pull request will surface on the `OfficeDev/office-scripts-docs` site under Issues. When the pull request is accepted, the issue will be resolved.
 
-#### Create a new branch after merge
+#### Create a new branch after the merge
 
 After a branch is successfully merged (that is, your pull request is accepted), don't continue working in that local branch. This can lead to merge conflicts if you submit another pull request. To do another update, create a new local branch from the successfully merged upstream branch, and then delete your initial local branch.
 
-For example, if your local branch X was successfully merged into the OfficeDev/office-scripts-docs master branch and you want to make additional updates to the content that was merged. Create a new local branch, X2, from the OfficeDev/office-scripts-docs master branch. To do this, open GitBash and execute the following commands:
+For example, if your local branch X was successfully merged into the OfficeDev/office-scripts-docs main branch and you want to make additional updates to the content that was merged. Create a new local branch, X2, from the OfficeDev/office-scripts-docs main branch. To do this, open Git Bash and execute the following commands:
 
     cd office-scripts-docs
-    git pull upstream master:X2
+    git pull upstream main:X2
     git push origin X2
 
 You now have local copies (in a new local branch) of the work that you submitted in branch X. The X2 branch also contains all the work other writers have merged, so if your work depends on others' work (for example, shared images), it is available in the new branch. You can verify that your previous work (and others' work) is in the branch by checking out the new branch...
 
     git checkout X2
 
-...and verifying the content. (The `checkout` command updates the files in `C:\Users\<yourusername>\office-scripts-docs` to the current state of the X2 branch.) Once you check out the new branch, you can make updates to the content and commit them as usual. However, to avoid working in the merged branch (X) by mistake, it's best to delete it (see the following **Delete a branch** section).
+...and verifying the content. (The `checkout` command updates the files in `C:\Users\<your username>\office-scripts-docs` to the current state of the X2 branch.) Once you check out the new branch, you can make updates to the content and commit them as usual. However, to avoid working in the merged branch (X) by mistake, it's best to delete it (see the following **Delete a branch** section).
 
 #### Delete a branch
 
 Once your changes are successfully merged into the main repository, delete the branch you used because you no longer need it.  Any additional work should be done in a new branch.  
 
 #### To delete a branch
 
-1. In the Git Bash command prompt, type `git checkout master`. This ensures that you aren't in the branch to be deleted (which isn't allowed).
+1. In the Git Bash command prompt, type `git checkout main`. This ensures that you aren't in the branch to be deleted (which isn't allowed).
 2. Next, at the command prompt, type `git branch -d <branch name>`. This deletes the branch on your computer only if it has been successfully merged to the upstream repository. (You can override this behavior with the `–D` flag, but first be sure you want to do this.)
-3. Finally, type `git push origin :<branch name>` at the command prompt (a space before the colon and no space after it).  This will delete the branch on your github fork.  
+3. Finally, type `git push origin :<branch name>` at the command prompt (a space before the colon and no space after it).  This will delete the branch on your GitHub fork.  
 
 Congratulations, you have successfully contributed to the project!
 
@@ -181,7 +181,7 @@ Fill out the form at [Join GitHub](https://github.com/join) to open a free GitHu
 
 You will automatically be sent a notice that you need to sign the Contributor's License Agreement (CLA) if your pull request requires one.
 
-As a community member, **you must sign the Contribution License Agreement (CLA) before you can contribute large submissions to this project**. You only need complete and submit the documentation once. Carefully review the document. You may be required to have your employer sign the document.
+As a community member, **you must sign the Contribution License Agreement (CLA) before you can contribute large submissions to this project**. You only need to complete and submit the documentation once. Carefully review the document. You may be required to have your employer sign the document.
 
 ### What happens with my contributions?
 
@@ -200,7 +200,6 @@ Pull requests are typically reviewed within 10 business days.
 * To learn more about Markdown, go to the Markdown creator's site [Daring Fireball].
 * To learn more about using Git and GitHub, first check out the [GitHub Help].
 
-[GitHub Home]: http://github.com
 [GitHub Help]: http://help.github.com/
 [Set up Git]: https://help.github.com/articles/set-up-git/
 [Daring Fireball - Markdown]: http://daringfireball.net/projects/markdown/

docs/testing/power-automate-troubleshooting.md

@@ -2,7 +2,7 @@
 title: Troubleshoot Office Scripts running in Power Automate
 description: Tips, platform information, and known issues with the integration between Office Scripts and Power Automate.
 ms.topic: troubleshooting-general
-ms.date: 02/08/2024
+ms.date: 08/13/2024
 ms.localizationpriority: medium
 ---
 
@@ -95,6 +95,12 @@ There are two reasons that the parameters or returned data of a script are not a
 
 The signature of a script is stored with the **Excel Business (Online)** connector when it is created. Remove the old connector and create a new one to get the latest parameters and return values for the **Run script** action.
 
+## Some web APIs not available with Power Automate flows
+
+Some web APIs, such as `TextEncoder` and `Crypto`, may not be available when running Office Scripts in Power Automate flows. See [MDN Web APIs](https://developer.mozilla.org/docs/Web/API) for a full list of web APIs.
+
+Power Automate returns the error `*API* is not defined`, where `*API*` specifies a library such as `TextEncoder`, when running a script that uses an unsupported API.
+
 ## See also
 
 - [Troubleshoot Office Scripts](troubleshooting.md)