Fix canonical URLs to use direct page paths

[AlexDaines]

Description

• Changes canonical URLs from index.html?page=X&tocid=Y to direct paths like items/S3/TS3Client.html
• Adds <meta name="aws-tocid"> for redirect logic
• Updates parentloader.js to read tocid from meta tag

Motivation and Context

Canonical URLs pointed to frameset with query params. Search engines saw mismatch between canonical and actual page URL, hurting indexing.

Testing

• Built doc generator
• Verified canonical URLs on class, namespace, and method pages
• Confirmed redirect behavior preserved via meta tag

Types of changes

• Bug fix (non-breaking change which fixes an issue)

Checklist

• My code follows the code style of this project
• I have read the README document
• All new and existing tests passed

License

• I confirm that this pull request can be released under the Apache 2 license

[GarrettBeatty]

can you share the exact testing steps/validations/screenshots that you tested?

[GarrettBeatty]

is this file generated? i see its in output-files folder.

[Copilot]

Pull request overview

This PR updates the documentation generator to fix canonical URL formatting for better search engine indexing. The change moves from query parameter-based URLs (index.html?page=X&tocid=Y) to direct path URLs (items/S3/TS3Client.html), while preserving frameset redirect functionality through a new meta tag.

Key Changes

• Canonical URLs now point directly to documentation pages instead of frameset with query parameters
• Added <meta name="aws-tocid"> tag to store the table of contents ID needed for redirect logic
• Updated JavaScript redirect logic to read tocid from meta tag instead of parsing canonical URL

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
docgenerator/SDKDocGeneratorLib/Writers/BaseWriter.cs	Updated canonical URL format to use direct paths and added aws-tocid meta tag
docgenerator/SDKDocGeneratorLib/output-files/resources/parentloader.js	Modified frameset redirect logic to read tocid from meta tag and construct URL from current pathname

[Copilot]

The page parameter should include the full relative path from /items/ (e.g., S3/TS3Client.html), not just the filename. This is inconsistent with how displayLink is called in BaseWriter.cs line 245-246, which passes GenerateFilepath() + '/' + GenerateFilename().

Current code extracts only the filename:

var filename = pathname.substring(pathname.lastIndexOf('/') + 1);

Should extract the full path after /items/:

var pagePath = pathname.substring(itemsIndex + '/items/'.length);

Then use:

window.location.href = basePath + '/index.html?page=' + pagePath + '&tocid=' + tocid;

Suggested change

	var filename = pathname.substring(pathname.lastIndexOf('/') + 1);
	//Reload the parent frameset and this content page. The inFrame part of this script
	//will run on reload to replace the address bar URL with the actual friendly content
	//frame page URL.
	window.location.href = basePath + '/index.html?page=' + filename + '&tocid=' + tocid;
	var pagePath = pathname.substring(itemsIndex + '/items/'.length);
	//Reload the parent frameset and this content page. The inFrame part of this script
	//will run on reload to replace the address bar URL with the actual friendly content
	//frame page URL.
	window.location.href = basePath + '/index.html?page=' + pagePath + '&tocid=' + tocid;