User:FrozenPlum: Difference between revisions

m
Add the infobox sample reminder for when I get to this portion
imported>FrozenPlum
mNo edit summary
imported>FrozenPlum
m (Add the infobox sample reminder for when I get to this portion)
Line 11:
 
==DPL3 Code Demos==
I'm aware almost all use examples are currently broken, this is intentional until they can be replaced because this resource is in development. It is not ideal to have manual pages manifest inside the manual itself (this adds a level of unnecessary complexity for new users). Ideally, it would be optimal to have different example categories to draw from (e.g., fruit, pastries, citiescountries, etc.) that are overly simple, and nearly impossible to confuse with other site content. Some time is needed to determine a solid instructional plan for this, it will likely be similar to the examples used in the [[mw:Help:Tables#class="wikitable"|Help:Tables]] page to explain tables simply, on MediaWiki.org. It is best practice to begin with the simplest examples possible, to avoid ambiguity and any level of unnecessary complexity. This type of approach shifts the focus from the output to the learning at hand because the concepts used in the examples are highly intuitive and easily understood orenough to mostly be ignored. It is best practice to use simple concepts in examples, and only add complexity ofto the learning itself (not the examples) as the complexity of the task increases. I need some time to think of a solid structure and organization for these "demo pages" (such as category:fruit, category:pastry category:citycoutries etc). Please be patient, until the examples are corrected, please use the [[wikia:Extension:DPL3/Manual|Gamepedia DPL3 Manual]].
 
==Examples==
It would be good to have "more examples" '''links''' in-line, in each parameter's page section, that display a full selection of examples specific to a given parameter. <s>Ideally, these should be named with parameter name first, followed by "example" or "(Example)"; this allows examples to be quickly-skimmable from different entry points</s> (there are practical reasons for this as-is). EntryDifferent entry points, likesuch as the [[Examples]] page and [[:Category:Examples|Examples]] category (which, will have different organization). <s>Having the key words at the beginning of each page title makes readers do less work (not having to read past "Example:_" every time, to find what they want (they can ignore the word "Example/example" if placed at the end</s> (while I don't love titles like "Parameter:_category" because it mimics a namespace, and if a "Parameters" namespace is created the blank space at the beginning will be removed and parameter name changed to title case, this is the only feasible way to have lowercase parameter names to avoid ambiguity, despite the unorthodox approach).</s>
 
The logic to rejigging the examples, is to cater to different audiences and '''entry points''' to the information:
Line 21:
 
An idea (that might not work), is that individual examples from "More Examples" ''may'' need their own pages, so they can be categorized by parameter use. If categorized by parameter use, these can be transcluded into the other pages mentioned ^ above. I'm still thinking about a system of sorts (and if this is even feasible) for this, it may take some time. Ideally, (also may not be feasible) I'd like a way to get each bit of code to go into a sandbox, with preloaded text, for someone to try manipulating.
 
From [[mw:Manual:Creating pages with preloaded text#Loading the preload file|Creating pages with preloaded text]] for sandbox test links, from example pages. "default=Special:Mypage/parametername test" loads "User:Username/parametername test" (a reminder that if already existing, the preload won't work, and to enter a distinct name other than "test" might work.
 
<pre>
<inputbox>
type=comment
default=Special:Mypage/inputbox test
type=create
preload=Log
</inputbox>
</pre>
 
The DPL2 site had an ''Examples'' category, but the examples had generic names like "Example 002" which made the task-based approach not feasible because you'd either have to click every one, or had to sift though manual sections like the Gamepedia Manual currently. Also, too many in-line examlpes can cause issues. Some titles are a little strange, like "Example:_Display_images_used" but that type of categorization and/or page might be a good idea for when users want to see different ways to display images! '''Relevant examples, to the task at hand, just need to be ''way'' easier to find,''' which is why I'd need some time to think about approaching this systematically.
Anonymous user