[docs] build with Documenter#master (v0.28-DEV)

[odow]

Preview link: https://jump.dev/JuMP.jl/previews/PR3094/JuMP.pdf

I've been working on a bunch of changes that will land in Documenter@0.28. They're currently unreleased, so here's a WIP PR to see them in practice.

• Style admonitions with tcolorbox in LaTeXWriter JuliaDocs/Documenter.jl#1932
• Change styling of code blocks in LaTeXWriter JuliaDocs/Documenter.jl#1935
• Wrap tabular environments in adjustbox to resize to page width JuliaDocs/Documenter.jl#1937
• Improve styling of tables in LaTeXWriter JuliaDocs/Documenter.jl#1938
• Small style tweaks to LaTeXWriter JuliaDocs/Documenter.jl#1954
• Fix title margin of admonitions in LaTeXWriter JuliaDocs/Documenter.jl#1955
• Make code block styling in LaTeXWriter consistent with HTML JuliaDocs/Documenter.jl#1956
• Switch to use {minted} for code output in LaTeXWriter JuliaDocs/Documenter.jl#1957

[codecov]

Codecov Report

Base: 97.68% // Head: 97.68% // No change to project coverage 👍

Coverage data is based on head (1634f8d) compared to base (2b7bdfc).
Patch has no changes to coverable lines.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #3094   +/-   ##
=======================================
  Coverage   97.68%   97.68%           
=======================================
  Files          33       33           
  Lines        4442     4442           
=======================================
  Hits         4339     4339           
  Misses        103      103           

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report at Codecov.
📢 Do you have feedback about the report comment? Let us know in this issue.

[odow]

Things are a lot better (compare against https://jump.dev/JuMP.jl/dev/JuMP.pdf).

Here are some thoughts of things we could still change:

We're missing the logo

The warning color looks gold, rather than yellow

is not the same as

I don't really like the font

Particularly these bullets

and you can't tell \texttt text

[odow]

Success! We can see the full table. cc @mortenpi

Here's a failure though:

GroupBy produces text with {tabular} inside them.

[odow]

@mortenpi muuuch better

[odow]

Closing. This can wait for the documenter release.

[mortenpi]

I would suggest using #master -- I don't have a clear ETA on the release right now.

[odow]

I would suggest using #master

Are more breaking changes expected? I guess the two breaking changes are pretty minor: https://github.com/JuliaDocs/Documenter.jl/blob/master/CHANGELOG.md#version-v0280-unreleased

[mortenpi]

I would like to get this one fixed, but it may lead to some slightly breaking behavior. Just been a little short on time right now.

[odow]

The two main arguments for switching are:

1. lots of improvements to the PDF
2. a link to GitHub from the header of each page!

These two changes are quite nice, and I try to stay abreast of the changes in Documenter, so I think I'm willing to live dangerously until the next release.

[mortenpi]

I would suggest committing a docs/Manifest.toml here though, to fix yourself to a commit. That would take some of the adrenaline out of your life.

[odow]

Perhaps I'll just use a specific commit for now.