Lots of new modders don't see the class descriptions. It doesn't matter too much for most classes, but for things like LuaItemStack it's quite important to read. It should really be at the very top of the page, so that you see it immediately. At the moment its under the summary of functions/variables, which is really arbitrary and hidden.
For clarification, I mean this part:
I'd do it myself with source access, but i'm not comfortable with python (which is used to generate the docs).
thx
Move doc's class description to top of page
Re: Move doc's class description to top of page
I agree with this, it's really easy to overlook in it's current position.
Re: Move doc's class description to top of page
Oxyd changed this for the next version:
I'm an admin over at https://wiki.factorio.com. Feel free to contact me if there's anything wrong (or right) with it.
Re: Move doc's class description to top of page
I don't like that its below the "class LuaItemStack - sort" text. Can that get changed real quick or should I make another interface request?
Re: Move doc's class description to top of page
I had the same initial reaction, however moving it above that would cause problems on pages with multiple classes, such as the concepts page. To illustrate, the description would above the class, so the gameviewsettings description would be where the green line is in this case:
I'm an admin over at https://wiki.factorio.com. Feel free to contact me if there's anything wrong (or right) with it.
Re: Move doc's class description to top of page
I think it would be better to have the description above the "sort" button on the class pages, and keep the concepts page as it is now. You can still read the description of the concepts if you click on the link to the concept.
Re: Move doc's class description to top of page
Changed for the next version:
I'm an admin over at https://wiki.factorio.com. Feel free to contact me if there's anything wrong (or right) with it.
Re: Move doc's class description to top of page
Perfect, I really appreciate this.