User blog comment:LadyAlys/"Information for Developers" Sections on Content Pages/@comment-24527829-20150517010915

I agree that the section should be the last section on any page, but I don't think it needs to be hidden. If it's at the bottom, it's easy enough to avoid if you don't want to read it. Plus, it's likely that devs will want to look at multiple pages in succession, and unhiding each individual page could get tedious very quickly.

In terms of what should be included, here's what I think: 1) Links to all relevant code. In some (maybe many) cases, this will require multiple links to multiple files. For example, in Skills we'd need to link to the the skill calculation algorithms, the code that changes the task/mouse behavior for task skills (i.e., the "hover" effect), the code that applies the skill calculations to the player/party etc. The idea is to make it as easy as possible for someone to find any and all code they may be looking for in relation to a specific thing. 2) Explanations of code/logic. This section should explain the linked code. It doesn't need to explain every single detail, but instead focus on the more complex/unintuitive items. A great example of this is the Key to the Kennels logic that I got tripped up in over a week ago. An explanation of the logic similar to the one you gave me in the guild would be extremely helpful here.