Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Embed the stable MathOptInterface docs into JuMP. #2522

Closed
wants to merge 9 commits into from
Closed

Conversation

odow
Copy link
Member

@odow odow commented Mar 16, 2021

Not sure if we should do this (ever, or just yet), but I thought I would see what it looks like and get some feedback.

I'll post the preview link once the build finishes.

https://jump.dev/JuMP.jl/previews/PR2522/moi/

The idea is to make it easier for the JuMP docs to link to the MOI documentation,
and provide a single, unified set of documentation for JuMP/MOI. This should allow us to de-duplicate things like "What is a caching optimizer", and it provides a way for JuMP users to see things like "What sets are supported by MOI"

Things are controlled by pinning the MOI version in docs/Project.toml, so whenever we release MOI, we should update the pin and tag a new JuMP release to push the new docs.

@codecov
Copy link

codecov bot commented Mar 16, 2021

Codecov Report

Merging #2522 (151b549) into master (35fd771) will increase coverage by 0.12%.
The diff coverage is n/a.

Impacted file tree graph

@@            Coverage Diff             @@
##           master    #2522      +/-   ##
==========================================
+ Coverage   93.37%   93.50%   +0.12%     
==========================================
  Files          44       44              
  Lines        5511     5926     +415     
==========================================
+ Hits         5146     5541     +395     
- Misses        365      385      +20     
Impacted Files Coverage Δ
src/mutable_arithmetics.jl 86.04% <0.00%> (+0.16%) ⬆️
src/macros.jl 93.89% <0.00%> (+0.98%) ⬆️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 35fd771...151b549. Read the comment docs.

@odow odow added the Status: Needs developer call This should be discussed on a monthly developer call label Mar 18, 2021
@odow odow changed the title RFC: Embed the stable MathOptInterface docs into JuMP. [Needs MOI 0.9.21] Embed the stable MathOptInterface docs into JuMP. Mar 25, 2021
@odow odow removed the Status: Needs developer call This should be discussed on a monthly developer call label Mar 25, 2021
@odow
Copy link
Member Author

odow commented Mar 25, 2021

Before merging this, we should update to the revised MOI docs (v0.9.21) and rewrite the introduction page to make clear that this is a copy of the MOI documentation.

@odow odow changed the title [Needs MOI 0.9.21] Embed the stable MathOptInterface docs into JuMP. Embed the stable MathOptInterface docs into JuMP. Apr 23, 2021
@odow odow closed this Apr 25, 2021
@odow odow reopened this Apr 25, 2021
odow and others added 5 commits April 25, 2021 15:46
This makes it easier for the JuMP docs to link to the MOI documentation,
and provides a single, unified set of documentation for JuMP/MOI.
@odow
Copy link
Member Author

odow commented Apr 25, 2021

So thoughts on this?

@joaquimg
Copy link
Member

I like this!
Brainstorming: should we add the warning explaining it is a copy of MOI docs in all pages? (I don't know, I liked to see it in the 1st page).

@odow
Copy link
Member Author

odow commented Apr 25, 2021

How's this:
image

@odow
Copy link
Member Author

odow commented Sep 22, 2021

Done in #2695

@odow odow closed this Sep 22, 2021
@odow odow deleted the od/moi_docs branch September 22, 2021 21:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Development

Successfully merging this pull request may close these issues.

3 participants