Workspace inheritance

[mmagician]

Description

Based off #556. Weirdly "Maintainers are allowed to edit this pull request.", but: I can make edits to the original PR via the UI (e.g. resolve conflicts), yet not push directly.

@Pratyush I've removed the line you added in ff/lib.rs in b031934, I wasn't able to build with it.

#![doc(html_in_header = include_str!("../../doc/katex-header.html"))]

closes: #556

This PR preserves the original commits and authorship.

---

Before we can merge this PR, please make sure that all the following items have been
checked off. If any of the checklist items are not applicable, please leave them but
write a little note why.

• Targeted PR against correct branch (master)
• Linked to GitHub issue with discussion and accepted design OR have an explanation in the PR that describes this work.
• Wrote unit tests N/A
• Updated relevant documentation in the code N/A
• Added a relevant changelog entry to the Pending section in CHANGELOG.md N/A
• Re-reviewed Files changed in the GitHub PR explorer

[Pratyush]

We should use per-crate keywords and categories

[mmagician]

Good catch 👍🏼

[mmagician]

We never had categories, but I brought back the old keywords: f01ed68

[Pratyush]

Does KaTeX get included in the docs for the files? That's what the #![doc(html_in_header = include_str!("../../doc/katex-header.html"))] was trying to achieve, I think?

[mmagician]

At least locally I can some correct display of equations, e.g. in target/doc/ark_ff/fields/trait.Field.html.

That said, I remember there was a difference between local vs actual deployment of docs and how KaTeX was packaged there, so hard to say. I think we can later build a few alpha versions and see, these are handled just as proper releases are in terms of doc deployment, AFAIR.

NB, including that #![doc...] line throws:

error: expected unsuffixed literal or identifier, found `include_str`
  --> ff/src/lib.rs:12:25
   |
12 | #![doc(html_in_header = include_str!("../../doc/katex-header.html"))]

[mmaker]

the copy-paste line for docs.rs was

rustdoc-args = [
    "--html-in-header", "doc/katex-header.html",
    "--cfg", "docsrs",
]

but also curious to see if that #![doc...] is sufficient

[Pratyush]

The #![doc(...)] line didn't work because the macro only accepts literals