Skip to content

Conversation

@hayden3456
Copy link

This PR adds source-linked, auto-generated docs for the codebase. Before you dismiss it: it includes inline source references, architecture diagrams, and I think it does a solid job. No hard feelings if you’d prefer not to include it.

If you find it useful, I’m building a documentation copilot to help explain why code is the way it is. It will:

  • Auto-sync docs
  • Asks a few questions on PR's to gather understanding as to why
  • Visualize the system at different levels of abstraction

I'm just building this out and would love to chat about what would help most so I can build something genuinely useful.
docforge.net

@CountBleck
Copy link
Member

I don't think we can reasonably accept automatically generated documentation, especially if it's generated by non-deterministic LLMs with a tool that isn't publicly available.

As a sidenote, it's a bit overkill with the diagrams, and there are some inaccuracies when describing how the compiler works.

In any case, it's hard to view this PR as credible when it's part of what I'm tempted to describe as a small-scale spam campaign aiming to advertise your product...

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants