Clean up and release documentation

[phisiart]

We have a number of work-in-progress markdown pages to release.

[bedros-p]

Can the docs include required (or tested) packages & their versions? It seems to fail compilation, I'm sure I'm missing something.

For whatever it's worth - sample logs -> logs.txt

The missing libraries were libstdc++ and all. Though, I'm unclear which version I'm supposed to use. These should all be listed in the dependencies, as the documentation even goes as far as to assume the user does not have Clang.

Not sure if it's a messed up Clang or Bazel, but the information for me to go off to debug anything is rather little - it seems to me that the original Maldoca had similar issues with the absl stuff - https://github.com/google/maldoca/pull/90/files ... super weird, considering the Github Actions builds with ubuntu-24.04, which is exactly what I'm on.

Aaanywways - not gonna make this comment about this particular issue though. Just that the docs could use:

• Required packages & versions that are verified to work with this (instead of a vague "tested on linux" + apt install clang as the versions can vary greatly)
• Required storage space before hitting the "cryptic error"

Otherwise, would it be possible to either Dockerize it (like Maldoca) for reproducibility / supply a compiled binary in the Releases tab?

Regardless, impressive work, thank you! If I could contribute to the docs in any way, lmk

[phisiart]

Thanks for the input!

We are currently focusing on releasing the removal of JSLIR and related documentation, as well as setting up a more sustainable sync schedule. We probably can only get to docker / build docs after these updates are done. In the meantime, if you could create a PR that updates the docs on build instructions and or provide a Dockerfile, that would be awesome! We mostly work in the "google internal" environment which is different from a normal Linux setup, so we have very limited exposure to "external" build issues, and really appreciate these kinds of input and/or help. Thanks again!

[bedros-p]

I'd love to :) on it asap, just that I happen to be in the middle of wiping my system clean - in the meantime, I've sent over an email, do check it out as soon as possible 😁

[phisiart]

Update: #34 released documentation on dataflow analysis.