Difference between revisions of "Docs Wiki Roadmap"
From Joomla! Documentation
m (→Investigation: on hold) |
m (→Short Term: updates) |
||
Line 7: | Line 7: | ||
*Identify documentation needs by user type better | *Identify documentation needs by user type better | ||
:*Beginners - need to be more targeted | :*Beginners - need to be more targeted | ||
− | ::*Easy Tutuorials - short and concise | + | ::*Easy Tutuorials - short and concise |
::*Beginners need targeted core ideas and methods (Too much information puts off) | ::*Beginners need targeted core ideas and methods (Too much information puts off) | ||
::*Easy to navigate and follow | ::*Easy to navigate and follow | ||
Line 20: | Line 20: | ||
:*Evaluators - ideas needed? | :*Evaluators - ideas needed? | ||
* <strike>Recognition of contributions, work on wiki</strike> complete, see [[Template:Barnstar|Barnstar awards]] | * <strike>Recognition of contributions, work on wiki</strike> complete, see [[Template:Barnstar|Barnstar awards]] | ||
− | *Home page - | + | *Home page - redesign is [[User:Hutchy68/New main page|here]] but template specific |
*Navigation | *Navigation | ||
+ | {{dablink|See [[JDOC:Documentation Navigational Structure]]}} | ||
:*Portal pages | :*Portal pages | ||
:*<strike>Better documentation search - Google integration? Lucerne?</strike> | :*<strike>Better documentation search - Google integration? Lucerne?</strike> | ||
Line 34: | Line 35: | ||
::'''Installed!''' and working now, see [[Special:AbuseLog|AbuseLog]] and [[Special:AbuseFilter|AbuseFilter]] | ::'''Installed!''' and working now, see [[Special:AbuseLog|AbuseLog]] and [[Special:AbuseFilter|AbuseFilter]] | ||
*Clean up redundant and incomplete pages (what was started and never finished, or redundant) ('''Underway!''') | *Clean up redundant and incomplete pages (what was started and never finished, or redundant) ('''Underway!''') | ||
− | :*< | + | :*<strike>Investigate 'Archive' namespace, would want an alias of 'A' to simplify link creation when needed</strike> ('''Completed''' - place to move out of date, historical doc pages. |
::'''Installed!''' Archive namespace and J1.5 for Joomla! 1.5 articles now being tagged ''Archived'' ('''Underway!''') | ::'''Installed!''' Archive namespace and J1.5 for Joomla! 1.5 articles now being tagged ''Archived'' ('''Underway!''') | ||
Revision as of 00:17, 27 August 2013
Please add appropriate items to the Roadmap and post all comments to the Docs Wiki Roadmap talk page.
Docs Wiki Roadmap[edit]
Short Term[edit]
- Identify documentation needs by user type better
- Beginners - need to be more targeted
- Easy Tutuorials - short and concise
- Beginners need targeted core ideas and methods (Too much information puts off)
- Easy to navigate and follow
Use of Header Tabs extension
- Installed! see example of use Hutchy68/Getting Started test page or Installing Joomla!
- Developers - more involvement, better method of involvement
- Projects - JDOC:Developer Tutorials Project,
- Better Event integration such as Pizza, Bugs and Fun. Doc's home page integration, upcoming events template.
- Web designers - target ease of design, better articles targeted towards CSS, Bootstrap
- Projects - need ideas
- Administrators - target common tasks with more detail
- Evaluators - ideas needed?
Recognition of contributions, work on wikicomplete, see Barnstar awards- Home page - redesign is here but template specific
- Navigation
- Portal pages
Better documentation search - Google integration? Lucerne?
- Installed! Google CSE, GoogleCustomWikiSearch - implemented and being used.
- Improve structure (underway!)
- Namespace aliases for easier link building
- Help screen aliasing - All Joomla! 3.x series Help screens will alias to one set of Help screens
Custom extension to tag Namespaces
- Disambiguation pages
Spam control - multipage sign up. AntiSpoof, AbuseFilter together.
AbuseFilter (Tested! - see Talk page) - will automatically block and remove users based on rules, can be new user time sensitive running against only new users.
- Installed! and working now, see AbuseLog and AbuseFilter
- Clean up redundant and incomplete pages (what was started and never finished, or redundant) (Underway!)
Investigate 'Archive' namespace, would want an alias of 'A' to simplify link creation when needed(Completed - place to move out of date, historical doc pages.
- Installed! Archive namespace and J1.5 for Joomla! 1.5 articles now being tagged Archived (Underway!)
Long Term[edit]
- Increase developer contributions!
- Welcome new users on user talk pages! Give them some additional information, style guide, templates available, etc.
- Editor assistance
- Adopt an editor? Help new wiki users
- Wiki Doc Projects - "JDOC Projects" - Portal page:JDOC Projects
- Developers
- Designers
- Better tutorials, multipage, PDF's created for download
- Developer feedback
- Enhance styleguide
- API integration with Platform and CMS
- Help Screen development simplify
- Focus on first STS, transcluded to subsequent STS versions, with a 'Final' for LTS
- Notices on support ended versions
- Better understanding for contributors, Help screens: how they work, why style guides are important
Nice to have eventually[edit]
VEL pageVEL now has its own subdomain, see http://vel.joomla.org.Improvement for editing by approved VEL membersSearchingImproved lookIntegration with administration for VEL notifications of installed Extensions.
- Multilingual support (Investigation underway) Translate Extension.
Investigation[edit]
- Semantic Mediawiki - On hold, but proof of concept worked - API Generated Docs, from XML each page updated with a Doxygen API rebuild.
- Use of property values within articles/API (testing underway!)
- Testing on a local MW install, use of Doxygen xml files to create API pages for documentation. Doxygen will not be the API generator.
- External data capture in XML or JSON (other formats also available)