08:48 <grim_> how is the pony stdlib documentation generated?

10:33 <FunkyBob> from the docstrings, it seems

10:34 <SeanTAllen> grim_: there's an option to the pony compiler to extract docs in mkdocs format that then is used to generate the HTML. You can use this on any project at the moment.

10:34 <grim_> alright, thanks!

10:35 <SeanTAllen> you can find the full details of how the online docs get updated in .travis.yml

10:35 <SeanTAllen> Is there a particular bit you are interested in?

10:39 <grim_> im considering trying to put together a tool/site for browsing the docs, as they currently are kind of hard to figure out, at least to me. i would for example like to see which classes implement a specific trait/interface

11:52 <Candle> grim_: I have a background thought of "add an index of the methods to the top of each class/actor/... file." but I have yet to dedicate sufficient time to it.

12:05 <SeanTAllen> Candle: the latter is fairly easy to do

12:06 <SeanTAllen> assuming you know c.

12:06 <SeanTAllen> Candle: check out docgen.c

12:07 <SeanTAllen> grim_: there's some tickets for creating multiple doc backends for producing different output. i think what would be good is the ability to create the basic info needed then additional tools to turn it into various formats instead of going straight to what mkdocs needs.

12:08 <SeanTAllen> if either of you is interested in working in that area, let me know. docgen is one of the first things i worked on when i started with Pony. I made a lot of improvements to the output docs but they could still be much much better

12:08 <SeanTAllen> I'm happy to help getting you going although my knowledge of the workings of the code itself is quite rusty.

12:10 <Candle> SeanTAllen: My c is ...poor, I can read it and comprehend it, but writing it is a different story.

12:11 <Candle> I see an opportunety to learn more!

12:20 <SeanTAllen> Candle: the nice thing about the C in docgen is that is you mess something up, usually, its quick to find out. run the docgen steps and it goes kaboom. it had been a while since i had written any c (about 5 years) so it was a nice intro to getting me back up to speed.

12:21 <SeanTAllen> grim_: so there's a bit of a quandry to consider.

12:22 <SeanTAllen> its really nice that the existing docgen can be used on any pony project to create docs that are easy to host. problem: those docs are kind of hard to navigate and there are lots of pony standard library specific things we could do but they would impact on the former.

12:23 <SeanTAllen> in general, the goal would be to try and keep what we have as something that is usable across projects but for large enough wins in terms of ease of use for standard library docs, we'd be willing to give that up

12:28 <SeanTAllen> FunkyBob: is your blog post in a shape where I can advertise it to the world?

12:58 <grim_> SeanTAllen, i'm not any good with C either, but i'll do toying with the docgen. will reach out if i hit any stumbling blocks

13:09 <FunkyBob> SeanTAllen: ah, not quite... I'll work on it now

13:14 <FunkyBob> SeanTAllen: give it a read... tell me what you think, please :) http://musings.tinbrain.net/blog/2017/may/11/learning-pony/

13:36 <SeanTAllen> i think its a good simple intro to what you've done so far FunkyBob

13:37 <SeanTAllen> Shall I blast it out to the world via Ponylang twitter and in "Last Week in Pony"?

13:38 <SeanTAllen> also, if yes, do you have a name you'd prefer to be credited under other than "FunkyBob"?

13:58 <FunkyBob> sure

13:58 <FunkyBob> Curtis Maloney ... but I think more people know me by my nick :)

16:59 <SeanTAllen> FunkyBob: its gone out to the twitters and will be in the "planet pony" of the website soon. will also be in "Last Week in Pony" on Sunday.

23:43 <FunkyBob> SeanTAllen: ok , cool.. once I'm done refactorying one of my python libs, I'll post about my "bolted" http server

23:43 <FunkyBob> I have larger plans for it :)