title: Equation numbering in Jupyter notebooks
body: <p>The fact is, that in official documentation <a href="http://jupyter-notebook.readthedocs.io/en/latest/examples/Notebook/Typesetting%20Equations.html#Equation-Numbering-and-References" rel="noreferrer">Jupyter - motivating examples</a> stands</p>
  
  <blockquote>
    <p>Equation numbering and referencing will be available in a future version of the Jupyter notebook.</p>
  </blockquote>
  
  <p>I know there is a lot of discussion about this topic. There are some people who claim to solve this issue with some workarounds.</p>
  
  <p>But for ordinary user it is hard to understand the workarounds, or how dirty/useful the hacks really are.</p>
  
  <p>So my questions are:</p>
  
  <ol>
  <li><p>what means the "available in future version"? Does it mean something like "new month/year" or something like "probably never because it is too impossible"?</p></li>
  <li><p>If any of the workarounds provided on the Internet safe for a human consumption? I mean is it worthy? Because it is possible to use Sphinx or something else for creation of tutorials, it will be more work, but it will be more work that implementing some hacks, installing plug-ins and so on?</p></li>
  </ol>
  
  <p>Note: For somebody it could seems to be a question requiring opinion based answer, but I am pretty sure it is not. Any advice can help me (or others users) to make a good/bad decision.</p>