This change has been forced, despite the .gitignore created by rake.
Code examples and References headers have been removed due to no content needed there.
Reason for the change
Before this change, the page.path was attempting to replace page.url with the *.md extension that doesn't exist.
Would have used page.command but it didn't have cross platform consistency.
Would have flipped the target (swapping positions of page.url and page.path), but the related target string isn't complete enough to be auto resolved.
Related commands on documentation are inserted into an existing url, would have rewritten the frontmatter - but that would require changes on a majority of the api pages.
Description
The reason for the complex replacement join is due to how liquid identifies and handle strings (and also the order of execution)
Attempted: split, slice, append(related[1]), join(/)
Placing append before a join breaks the sequence and turns the array of strings into a concatenated string before the join can run resulting in apijavascriptnext instead of api/javascript/next/
Reason for the change
page.path
was attempting to replacepage.url
with the*.md
extension that doesn't exist.page.command
but it didn't have cross platform consistency.page.url
andpage.path
), but the related target string isn't complete enough to be auto resolved.Related commands on documentation are inserted into an existing url, would have rewritten the frontmatter - but that would require changes on a majority of the api pages.
Description
The reason for the complex replacement join is due to how liquid identifies and handle strings (and also the order of execution)
split, slice, join(/), append(/), append(related[1])
split, slice, append(related[1]), join(/)
Placing append before a join breaks the sequence and turns the array of strings into a concatenated string before the join can run resulting inapijavascriptnext
instead ofapi/javascript/next/
Checklist
Side notes
.gitignore
does not exclude the virtual environment created by rake.