RFC: Solution query docs

[joaquimg]

Sketch the solution query part of the manual

• Should we add tables to enums of point to the docstrings of the enum?

Targets: #1621

[codecov]

Codecov Report

Merging #1731 into master will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master    #1731   +/-   ##
=======================================
  Coverage   68.69%   68.69%           
=======================================
  Files          30       30           
  Lines        3891     3891           
=======================================
  Hits         2673     2673           
  Misses       1218     1218

---

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 a9d7e28...d59bb38. Read the comment docs.

[codecov]

Codecov Report

Merging #1731 into master will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master    #1731   +/-   ##
=======================================
  Coverage   68.92%   68.92%           
=======================================
  Files          30       30           
  Lines        3923     3923           
=======================================
  Hits         2704     2704           
  Misses       1219     1219

Impacted Files	Coverage Δ
src/constraints.jl	72.94% <ø> (ø)	⬆️

---

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 cca15bb...a710611. Read the comment docs.

[mlubin]

Does this display correctly? I didn't know you could display docstrings like this for other symbols in other packages.

[joaquimg]

I haven't tested.

[mlubin]

Please build the docs locally to double check that they display as intended.

[joaquimg]

yup

[odow]

[joaquimg]

@blegat, I understood that I cannot reference AbstractShape and dual_shape because they are no in the manual

[blegat]

The missing reference for shape is fixed but there are other issues remaining:
https://travis-ci.org/JuliaOpt/JuMP.jl/jobs/475843545#L639-L653

[odow]

I am addressing these comments now.