Align operator and property formatting for existing articles and tutorials #128
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Fixes #122 with the new standard formatting for operators and properties.
Changes Implemented
xreflinks foroperatorswere replaced with reference-stylexreflinks. If an operator had noxrefand was only highlighted with inline code formatting, a reference-style link was added.xreflinks were converted to reference-style links if the article was modified to use reference-style links.xreflinks forpropertieswere removed, leaving only inline code formatting.xreflinks for cross-references to other articles or external types were not converted.Issues Encountered
Operators from packages that do not currently have a
docfxreference page:PythonTransform), I have included a link to the nuget package instead. I figured this would serve as a signpost for people to look for the package in the Bonsai package manager, even though I know its not ideal.This preserves the operator formatting, but I recognize some of these changes might be controversial, so I have placed them at the end of the reference-style link section so that they can be easily removed. It also serves as a reminder to replace those links when we address them
Articles containing
includemarkdown files (e.g., Subjects):includemarkdown files rather than the root article.includemarkdown files are often used asReferenceoverwrite sections, placing reference-style links in the root article would not propagate them to theReferencepage. It just occurred to me that I was writing this up that I'm not sure that reference-style links placed in the root article would propagate to theincludesections.xreflinks in the root article were pointing to section links rather than API references. Adding reference-style links in the correspondingincludemarkdown files did not interfere with those section links. Just something to take note of.This has the effect that in
Referencepages where overwrite sections exist, operator references now containxreflinks pointing to their own page. While this maintains consistency in operator formatting, self-referencing links may not be ideal. We can discuss whether this change is desirable. For now, I have chosen not to apply this formatting to otherincludemarkdown files intended for overwrite in theReferencesection.