Re: [lldb-dev] [RFC] Moving away from epydoc for the LLDB SB API documentation

2020-11-24 Thread Jordan Rupprecht via lldb-dev
Based on looks alone, your Sphinx example feels the most polished to me. And it'd be consistent with the main LLVM docs, which is nice. However, the pdoc3 feels much more *usable* (easier to skim through, I love the one-pager-ness of it), so that's where my vote is going too. It'd be nice if the p

[lldb-dev] [RFC] Moving away from epydoc for the LLDB SB API documentation

2020-11-24 Thread Raphael “Teemperor” Isemann via lldb-dev
Hi all, some of you might have noticed that the Python SB API documentation on the website hasn't been regenerated since more than a year. I pinged Andrei about fixing the broken generation script. While I was trying to recreate the doc generation setup on my machine I noticed that our document