Log file Viewer

[17:18:01] <agronholm> hm, rst2html does not complain

[17:18:06] <agronholm> I wonder if it's due to the indentation

[17:18:30] <ngoldbaum> i thought you needed to explicitly include the readme text in the call to setup()

[17:18:31] <ngoldbaum> https://github.com/agronholm/asyncio_extras/blob/master/setup.py

[17:18:55] <ngoldbaum> https://github.com/yt-project/unyt/blob/master/setup.py#L44

[17:19:11] <ngoldbaum> or does setuptools automatically use README.rst if you don't specify long_description?

[17:21:36] <agronholm> ngoldbaum: https://github.com/agronholm/asyncio_extras/blob/master/setup.cfg#L4

[17:22:23] <ngoldbaum> ah, TIL

[17:23:16] <agronholm> even if I indent and space my badges exactly as you do, I still get an error

[17:23:47] <ngoldbaum> super weird

[17:23:52] <ngoldbaum> maybe open an issue against warehouse?

[17:24:05] <agronholm> this isn't a warehouse problem

[17:24:25] <agronholm> rst2html.py from docutils gives me this error, as does the online tool (rst.ninjs.org)

[17:25:39] <agronholm> ahhhh

[17:25:42] <agronholm> I finally figured it out

[17:25:48] <ngoldbaum> typo somewhere?

[17:25:52] <agronholm> the first line in the first paragraph is indented

[17:25:57] <ngoldbaum> ahhhh

[17:25:58] <agronholm> after the tags

[17:26:00] <ngoldbaum> rst is the worst

[17:26:02] <ngoldbaum> seriously

[17:26:20] <ngoldbaum> i think i only know one or two people that actually enjoy writing things in rst

[17:26:25] <ngoldbaum> latex is more popular :(

[17:58:54] <toad_polo> I don't really care for RST, but markdown isn't really enough usually and RST is almost readable.

[18:00:16] <sumanah> I'm trying to remember - there must be an rst linter somewhere?

[18:00:28] <sumanah> hi toad_polo how are things going?

[18:01:29] <toad_polo> Pretty well. Most of the way done with my crazy month.

[18:02:42] <toad_polo> PyCon, internal conference and a meetup talk done, just need to do PyLondinium and move.

[18:03:05] <ngoldbaum> sumanah: flycheck can check sphinx docs (although it's not so useful if your sphinx build takes anything more than a few seconds)

[18:03:43] <ngoldbaum> markdown certainly isn't sufficient to write a book in

[18:03:49] <ngoldbaum> you could write a book in rst though

[18:03:53] <ngoldbaum> it's great, i'd like it a lot more

[18:04:01] <ngoldbaum> except the syntax is impossible to remember

[18:04:15] <ngoldbaum> i need to look up how to make hyperlinks every time i need to do that

[18:04:21] <ngoldbaum> in markdown it's just []()

[18:06:31] <sumanah> The more complicated the syntax for something I have to write, the more likely I am to write it in HTML or Markdown and then use pandoc to turn it into reStructuredText

[18:06:41] <sumanah> I mean, assuming I need to have it in .rst

[18:08:57] <sumanah> thank you pandoc, and while I am at it, thank you pdftk, and thank you readme_renderer, and thank you `mkdir -p`

[18:16:09] <ngoldbaum> and thank you sumanah - pypi.org is great :)

[18:17:36] <sumanah> ngoldbaum: AWWW thanks! :D

[18:17:57] <sumanah> we had a great team and we had funding -- was a great experience

[23:04:46] <bitdancer> I have to look up markdown syntax every time I use it, probably because I don't use it often. RST not so much, except for the *extended* forms of hyperlinks/footnotes, which markdown doesn't support. RST is IMO much prettier than markdown, which I consider to be a major plus since I mostly read the raw doc and not the rendered form.

[23:06:41] <ngoldbaum> it's petty but that's how it goes for me

[23:14:48] <bitdancer> I guess it's like vi versus emacs :) We'll just stop discussing it :) :)