<div dir="ltr"><div><div><div>Hi all,<br><br></div><div>I noticed there&#39;s plenty of activity reorganizing the PANDA documentation. While this was much needed and is definitely welcome, I&#39;d like to express a few concerns related to the ongoing reorganization.<br></div><div><br></div><div>Monolithic manual. I hope this is only temporary and we&#39;ll have split files at the end of the reorganization. I find having the manual as a single markdown file very unwieldy and impractical. You won&#39;t ever need *all* the information at the same time. With 2k lines to scroll through, finding what you want becomes very difficult.<br></div><div><br></div>Removing <a href="http://compile.md">compile.md</a>. I don&#39;t understand why this part of documentation was killed. This makes it more difficult to install PANDA on anything else than Debian/Ubuntu. It was much easier to go through <a href="http://compile.md">compile.md</a> and adapt each step to your OS than reading and adapting the bash script.<br></div>Moreover, it seems the bash script has currently been tested only for Debian 7. E.g. llvm-3.3 is not available for Debian 8. So now you have to go google how to install it, something that was already documented.<br></div><div>Plus, many first-time users may not be comfortable running a script that they haven&#39;t carefully examined and alters their system.<br></div><div><br></div><div>Documentation namespacing - or lack thereof. The current restructuring seems like a good opportunity to use some sort of namespacing for the documentation. E.g. rename stuff related to PANDA core to panda_*.md, plugin related stuff to plugin_*.md, use cases (e.g. dynamic slicing) to usecase_*.md. This doesn&#39;t seem to be planned for now.<br><br></div><div>I&#39;m willing to contribute towards addressing these concerns if there is a consensus for any of them.<br><br></div><div>Cute logo btw. Sign me up when you order for PANDA tshirts :)<br></div><div><br></div><div>Best regards,<br></div><div>Manolis<br></div></div>