Fixed W3C WebDriver Spec links in API docs.

[Halim-Shams]

@garg3133 Review the requested changes for the issue of fixing the broken links and categorizing them. nightwatchjs/nightwatch-docs#293

I've reviewed all the Nightwatch APIs documentation and did the following:

• Placed and moved all the W3C-related links to @link tag in JSDoc.
• Placed and moved all other links to @see tag in JSDoc.
• Fixed all the broken links.
• Reduced the complete URLs to only /#abc-abc format.

Let me know if these changes are appropriate or if it needs some improvements.

[CLAassistant]

All committers have signed the CLA.

[garg3133]

This looks good, thanks a lot!

Hope you've verified that all the links that are part of the @link tag actually work.

[garg3133]

@Halim-Shams Like I mentioned before, package-lock.json file shouldn't be a part of this PR. To do that, directly deleting the file won't help because the PR now shows that the file should be deleted from the repository itself, which isn't what we want.

Instead, what you can do is copy the package-lock.json file from the original repository and save it in your local project, commit it and then push it to this branch. That should remove the changes related to the package-lock.json file from this PR.

[ParmarKrishna]

I think, what @garg3133 is trying to convey is, package-lock.json shouldn't be listed as one of the files that has changes in the "File Changed" section of your commit.

[Halim-Shams]

@garg3133 I've copied the code from the original repo's package-lock.json file and pasted it into my local package-lock.json file, and everything works the way expected.

[garg3133]

You could check if the changes you're making are taking effect on the actual website or not by setting up the nightwatch-docs project locally and then setting API_DOCS_FOLDER option in postdoc.config.js to point to your Nightwatch repository.

Also, this PR does not fix "all" the links in the repository as the title claims, but fixing these many links is also fine for now.

[Halim-Shams]

@garg3133 The suggestions were modified, and it worked successfully by running the nightwatch repo inside the nightwatch-docs repository.

If you see any issue do let me know.

[github-actions]

Status

• ❌ No modified files found in the types directory.
  Please make sure to include types for any changes you have made. Thank you!.

[garg3133]

Looks good now. I've fixed a few other W3C links and migrated them from the @see tag to the @link tag.

Thanks a lot for this PR.