Difference between revisions of "Docs Wiki Roadmap"
From Joomla! Documentation
m (→Nice to have eventually: formatting fix) |
m (→Nice to have eventually: update) |
||
(8 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
− | {{shortcut|JDOC:DWR|JDOC:MAP}}{{notice|Please add appropriate items to the Roadmap and post all comments to the [[JDOC_talk:Docs Wiki Roadmap|Docs Wiki Roadmap]] talk page. | + | {{shortcut|JDOC:DWR|JDOC:MAP}}{{notice|Please add appropriate items to the Roadmap and post all comments to the [[JDOC_talk:Docs Wiki Roadmap|Docs Wiki Roadmap]] talk page.|title=Contributions Welcome}} |
− | |||
==Docs Wiki Roadmap== | ==Docs Wiki Roadmap== | ||
Line 7: | Line 6: | ||
*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 19: | ||
:*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> | ||
− | ::'''Installed!''' Google CSE, [[Special:GoogleCustomWikiSearch|GoogleCustomWikiSearch]] - | + | ::'''Installed!''' Google CSE, [[Special:GoogleCustomWikiSearch|GoogleCustomWikiSearch]] - implemented and being used. |
− | :*Improve structure (underway!) | + | :*Improve structure ('''underway!''') -Building menu system |
::*Namespace aliases for easier link building | ::*Namespace aliases for easier link building | ||
:::'''Help screen aliasing''' - All Joomla! 3.x series Help screens will alias to one set of Help screens | :::'''Help screen aliasing''' - All Joomla! 3.x series Help screens will alias to one set of Help screens | ||
Line 33: | Line 33: | ||
:*<strike>AbuseFilter (Tested! - see [[JDOC_talk:Docs Wiki Roadmap|Talk page]]) - will automatically block and remove users based on rules, can be new user time sensitive running against only new users.</strike> | :*<strike>AbuseFilter (Tested! - see [[JDOC_talk:Docs Wiki Roadmap|Talk page]]) - will automatically block and remove users based on rules, can be new user time sensitive running against only new users.</strike> | ||
::'''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) | + | *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'' | + | ::'''Installed!''' Archive namespace and J1.5 for Joomla! 1.5 articles now being tagged ''Archived'' ('''Underway!''') |
===Long Term=== | ===Long Term=== | ||
Line 48: | Line 48: | ||
:*Developer feedback | :*Developer feedback | ||
:*Enhance styleguide | :*Enhance styleguide | ||
− | *API integration with Platform and CMS | + | *<strike>API integration with Platform and CMS</strike> see http://api.joomla.org |
*Help Screen development simplify | *Help Screen development simplify | ||
− | **Focus on first STS, transcluded to subsequent STS versions, with a 'Final' for LTS | + | **<strike>Focus on first STS, transcluded to subsequent STS versions, with a 'Final' for LTS</strike> Refer to https://github.com/joomla/joomla-cms/issues/5007 for information about automation of help screens |
**Notices on support ended versions | **Notices on support ended versions | ||
**Better understanding for contributors, Help screens: how they work, why style guides are important | **Better understanding for contributors, Help screens: how they work, why style guides are important | ||
Line 60: | Line 60: | ||
**<strike> Improved look</strike> | **<strike> Improved look</strike> | ||
**<strike> Integration with administration for VEL notifications of installed Extensions.</strike> | **<strike> Integration with administration for VEL notifications of installed Extensions.</strike> | ||
− | * Multilingual support | + | *<strike>Multilingual support '''(Investigation underway)''' Translate Extension.</strike> See [[JDOC:Documentation Translators|Documentation Translators]] |
==Investigation== | ==Investigation== | ||
− | *Semantic Mediawiki | + | *<strike>Semantic Mediawiki - '''On hold, but proof of concept worked''' - ''API Generated Docs, from XML each page updated with a Doxygen API rebuild.''</strike> |
:*Use of property values within articles/API (testing underway!) | :*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. | + | ::*<strike>Testing on a local MW install, use of Doxygen xml files to create API pages for documentation. '''Doxygen will not be the API generator.'''</strike> |
:*External data capture in XML or JSON (other formats also available) | :*External data capture in XML or JSON (other formats also available) | ||
<noinclude>[[Category:Documentation Wiki Information|{{PAGENAME}}]] | <noinclude>[[Category:Documentation Wiki Information|{{PAGENAME}}]] |
Revision as of 10:08, 10 November 2014
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!) -Building menu system
- 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 CMSsee http://api.joomla.org- Help Screen development simplify
Focus on first STS, transcluded to subsequent STS versions, with a 'Final' for LTSRefer to https://github.com/joomla/joomla-cms/issues/5007 for information about automation of help screens- 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.See Documentation Translators
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)