I’ve been thinking about this since I started with UE, and I, as well as others have mentioned this before at times and it has stayed on my mind for the whole time.
(Note: I’m aware of the recent improvements & the attempt to update old docs & bring in new ones, and good job on that effort so far.)
All docs, tutorials, wiki, etc. should be Stamped with the Date & Version (&/or revisions) that are applicable, this usage should even be followed in the forums, especially by Epic then the community should follow thru when asking questions etc. as well.
Even if you used an old tutorial etc. at least you would know it, and would expect some issues & could update Epic on anything that didn’t work or work as expected.
Any images should not be resolution dependent and/or should be full sized &/or scrollable, sorry but I use a 22" monitor not a 51" theatre system or dual-monitor system to work on. so many times either I could barely see an image or not at all. Once had the image to run off my screen. (the forums are included in this scenario)
Doc, wiki, tutorial images could then include Tooltips as well as Links to much needed references to the standard nodes being used, the project created nodes within the material should be covered within the subject matter itself, especially when they are created off certain pins or require certain objects to be set/created in other BPs.
And anything else that future needs might present or make available, text documents or even technical papers could be added. (altho’ the latter always went over my head in the past)
These links to references on the subject and the Nodes involved should be more than just showing input or output pins, they should have details on their use & usage and explained as fully as possible, even to link to what they are or should be associated with. (huge effort required I know but…)
All or as much as possible should be searchable, even the date stamp - version should show in the search results field. When conducting a search, no-one has an idea what they are clicking on, even some search results still point to UDK & other older versions. (which ain’t bad but at least one would know when they clicked it)
>>> Everywhere one looks they should know what version & what date the item was created and what it applies to.
>>> This would also help when updating of the Docs, etc. is required.
As a Note: I don’t believe that UE should do all the work, they’ve done most of it already, and I am not looking for an ‘Easy Button’ or ‘Create Game’ icon to click. But I do ask to be able to use and understand all the documentation, tutorials, and wikis. I came to learn and a user should delve into the docs / wiki / tutorials on their own and work through them themselves to build knowledge of the engine and it’s uses. Nothing can be accomplished by copying projects and/or nodes & pasting. This would hinder the learning process and defeat the purpose, then no one would gain from it. The user would just become more & more dependent on others to do the work for them and never accomplish anything themselves, and Epic would never be able to keep up with it.
ps: This is my opinion and should not reflect on how much I appreciate what exists at the moment, I know there has been a great deal of effort & also a forth-going effort to deal with all this. I just hope this will help.
And I hope that others would voice their opinions and ideas on this subject as well, here or elsewhere.