Dropping the Tutorial namespace
Posted: Tue Jan 11, 2011 4:45 pm
As the title says, I would like to propose the removal of the Tutorial namespace in favour of the Tutorial category. I've been looking into consolidating the different types of information on the Wiki (such as FAQs, tutorials, help screens, API docs etcetera) and I can name the following arguments for removal:
By the way, shouldn't there be a central JDOC discussion page on the wiki for such proposals? On projects like Wikipedia, it seems that keeping the discussion right next to the discussed content works better than having a separate resource.
- Consistency: there's no FAQ namespace, though API15, API16 etc. are admittedly useful. However, tutorials do not have a significantly 'special' structure that would warrant a namespace.
- Flexibility: categories are easier to add and remove, not to mention the fact that categories can have subcategories and are easier to view an index of.
- Extensions: index articles such as the Management series use the DPL extension, which selects articles based on their categories and not their namespace. For example, http://docs.joomla.org/Tutorial:Override_JFormFields is not shown in the list.
- Use: http://docs.joomla.org/Category:Tutorials shows that either documentors are ignorant of the namespace, or they just like categories more, as the majority of the tutorials does not use the namespace. The list of Tutorial: articles can be found on http://docs.joomla.org/index.php?title= ... amespace=0
By the way, shouldn't there be a central JDOC discussion page on the wiki for such proposals? On projects like Wikipedia, it seems that keeping the discussion right next to the discussed content works better than having a separate resource.