add Topiary to “Formatting Your Code”

[toastal]

Topiary is a viable code formatter for OCaml projects. My favorite feature compared to its competitor is that Topiary can be configured to use tab indentation for user accessibility (which affects me). While Topiary can be configured, it isn’t as intuitive to configure as many other code formatters that just look for a specific file in a specific location.

Additionally, I removed the implicit assumptions of OCamlFormat in the description & title since the sidebar & URL slug generically state “Formatting Your Code” without specifying a tool. This also required moving the file whose name implied OCamlFormat.

It would have been nice to use a callout/admonition for the “TIP:”, but Markdown does not support this feature.

¹

Footnotes

1. Please consider giving up MS GitHub or offering a non-proprietary, non-US-corporate-controlled mirror for this free software project. I wish to delete this Microsoft account in the future, but I need more projects like this to support alternative methods to send patches & contribute. ↩

[bbatsov]

You've changed the URL of the page, so you'll need to add some redirect from the old one.

[toastal]

You've changed the URL of the page, so you'll need to add some redirect from the old one.

I don’t think this is true. The Markdown YAML heading thing’s id value has not changed. However, the filename (& title) should change as it doesn’t reflect that id (& by proxy the URL slug) as well as the sidebar’s “Formatting your Code” — else you don’t want to give the wrong impression that there is just one formatter.

[bbatsov]

I don’t think this is true. The Markdown YAML heading thing’s id value
has not changed. However, the filename (& title) should change as it
doesn’t reflect that id (& by proxy the URL slug) as well as the
sidebar’s “Formatting your Code” — else you don’t want to give the wrong
impression that there is just one formatter.

My bad. I saw the filename change and at first I assume that the slug was changed to match it.