Obligatory post; documentation was mentioned.

It's looking like you guys will have real documentation now. Ondra is my hero

they think, they have to make ONE documentation.

Yes, it's important to note that there are many different types of documentation. What we're talking about here is mostly Reference Documentation (since that's the only type of documentation that can be auto-generated). This is the documentation ...

So how would you split the documentation up? Certainly it can't all be just one page, that would get super-messy. On the other hand, you feel that the current way of splitting it is too much.

Many popular libraries use the single-page approach with very good effect. The single-page style can ...

I agree that good code is extremely important, but I believe that good docs are needed as well. Not every little thing needs to be documented, that's definitely more effort than it's worth, but the functions and objects exposed to the public need to be explained properly.

At this point, this is ...

What counts in the end is running code. Not text.

I completely disagree.

If you rely on code as documentation, it makes it even more difficult to learn about. Sure, it's more "accurate", as you say, but there's a much higher learning curve to it as well. The point of documentation is to make it ...

Did you take a look at this?
https://forums.factorio.com/wiki/index.php?title=Lua_objects

Yes, that was part of the "very frustrating" comment. A wiki is not a good place for documentation.

From the perspective of someone trying to get into modding (ie. knows nothing about the API, like me ...

auto-generating the Lua API documentation

This is by far the most exciting (to me) issue mentioned in the Friday Fact; when might we actually see it in a roadmap?

I wanted to get into modding, but the current state of the documentation made it very frustrating. The only decent way to learn how ...