Fix DAG docstrings so they no longer produce improper HTML

[AetherUnbound]

Fixes

Fixes #4750 by @sarayourfriend

Description

This PR fixes a few instances of brackets within the DAG docstrings that would produce invalid HTML in the resulting document that gets rendered for the documentation site.

Testing Instructions

Run the following, and HTML should be output (without raising any errors):

1. ov just documentation/live
2. ov pnpm exec prettier documentation/_serve/catalog/reference/DAGs.html

Checklist

• My pull request has a descriptive title (not a vague title likeUpdate index.md).
• My pull request targets the default branch of the repository (main) or a parent feature branch.
• My commit messages follow best practices.
• My code follows the established code style of the repository.
• I added or updated tests for the changes I made (if applicable).
• I added or updated documentation (if applicable).
• I tried running the project locally and verified that there are no visible errors.
• I ran the DAG documentation generator (ov just catalog/generate-docs for catalog
  PRs) or the media properties generator (ov just catalog/generate-docs media-props
  for the catalog or ov just api/generate-docs for the API) where applicable.

Developer Certificate of Origin

Developer Certificate of Origin

Developer Certificate of Origin
Version 1.1

Copyright (C) 2004, 2006 The Linux Foundation and its contributors.
1 Letterman Drive
Suite D4700
San Francisco, CA, 94129

Everyone is permitted to copy and distribute verbatim copies of this
license document, but changing it is not allowed.


Developer's Certificate of Origin 1.1

By making a contribution to this project, I certify that:

(a) The contribution was created in whole or in part by me and I
    have the right to submit it under the open source license
    indicated in the file; or

(b) The contribution is based upon previous work that, to the best
    of my knowledge, is covered under an appropriate open source
    license and I have the right under that license to submit that
    work with modifications, whether created in whole or in part
    by me, under the same open source license (unless I am
    permitted to submit under a different license), as indicated
    in the file; or

(c) The contribution was provided directly to me by some other
    person who certified (a), (b) or (c) and I have not modified
    it.

(d) I understand and agree that this project and the contribution
    are public and that a record of the contribution (including all
    personal information I submit with it, including my sign-off) is
    maintained indefinitely and may be redistributed consistent with
    this project or the open source license(s) involved.

[github-actions]

Full-stack documentation: https://docs.openverse.org/_preview/4770

Please note that GitHub pages takes a little time to deploy newly pushed code, if the links above don't work or you see old versions, wait 5 minutes and try again.

You can check the GitHub pages deployment action list to see the current status of the deployments.

Changed files 🔄:

• https://docs.openverse.org/_preview/4770/catalog/reference/DAGs.html

[krysal]

I couldn't build the documentation locally with the instructions, not even after doing a ./ov clean && ./ov init. I got the following error:

INFO: The saved Python interpreter doesn't match the project's requirement. Trying to find another one.
WARNING: Project requires a python version of ==3.11.*, The virtualenv is being created for you as it cannot be matched to the right version.
INFO: python.use_venv is on, creating a virtualenv for this project...
Virtualenv is created successfully at /opt/pdm/venvs/documentation-QbEAfFES-3.11
[PdmUsageError]: Command 'sphinx-autobuild' is not found in your PATH.
error: Recipe `live` failed on line 72 with exit code 1

Did this happen to you at some point by any chance?

[stacimc]

I'm experiencing the same issue as @krysal 🤔

[AetherUnbound]

Hmm, could it be an issue on OSX? @dhruvkb @obulat @zackkrida are you all able to confirm?

[zackkrida]

Same issue on Fedora!

> ov just documentation/live
rm -rf _serve/ _build
pdm run sphinx-autobuild -b html . _serve/ --port 50230
INFO: The saved Python interpreter doesn't match the project's requirement. Trying to find another one.
WARNING: Project requires a python version of ==3.11.*, The virtualenv is being created for you as it cannot be matched to the right version.
INFO: python.use_venv is on, creating a virtualenv for this project...
Virtualenv is created successfully at /opt/pdm/venvs/documentation-QrgCiFGL-3.11
[PdmUsageError]: Command 'sphinx-autobuild' is not found in your PATH.
error: Recipe `live` failed on line 72 with exit code 1

[AetherUnbound]

Ahhh okay, y'all may need to run ov just documentation/install first 😄 that fixed it for me! I'll see what we can change in the ov flow to remove this problem.