Jab2014 - Make Joomla! THE solution for online documentation
Upcoming SlideShare
Loading in...5
×
 

Jab2014 - Make Joomla! THE solution for online documentation

on

  • 494 views

Presentation slides of Nick's #jab14 session to Make Joomla! THE silution for online documentation

Presentation slides of Nick's #jab14 session to Make Joomla! THE silution for online documentation

Statistics

Views

Total Views
494
Views on SlideShare
465
Embed Views
29

Actions

Likes
0
Downloads
3
Comments
0

1 Embed 29

http://jandbeyond.org 29

Accessibility

Categories

Upload Details

Uploaded via as Microsoft PowerPoint

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment

Jab2014 - Make Joomla! THE solution for online documentation Jab2014 - Make Joomla! THE solution for online documentation Presentation Transcript

  • Make Joomla!THE solution for online documentation @ JandBeyond 2014
  • Hello I am Nicholas (Nick) Antimisiaris (aka nant on forums) Member of the Community Builder team Nant @ Joomlapolis.com and I LOVE Joomla! JAB-2014 © Joomlapolis - 2014 2
  • This presentation is about Something we can do to help make Joomla better JAB-2014 © Joomlapolis - 2014 3
  • Requirements / help form  Reminder – this form is for people interested in exploring the concept of using Joomla for their online documentation needs. goo.gl/UZ3RpY JAB-2014 © Joomlapolis - 2014 4
  • Presentation Agenda  The real motivation  The Joomla marketplace  Joomla for doc projects?  Existing documentation tools  Requirements analysis  Work in progress  Lets make Joomla a doc tool solution ! JAB-2014 © Joomlapolis - 2014 5
  • Motivation (repeating) To help make Joomla better JAB-2014 © Joomlapolis - 2014 6
  • But what is Joomla, really ?  Content Management System (CMS)  Open-source, GPL, Free to download and use  Technology: PHP, MYSQL, Apache, etc.  From the joomla.org site: Joomla is an award-winning content management system (CMS), which enables you to build Web sites and powerful online applications. JAB-2014 © Joomlapolis - 2014 7
  • Competition in the CMS market JAB-2014 © Joomlapolis - 2014 8 www.opensourcecms.com Making Joomla better
  • How competition define itself  Joomla: Joomla is an award-winning content management system (CMS), which enables you to buildWeb sites and powerful online applications. Many aspects, including its ease-of-use and extensibility, have made Joomla the most popularWeb site software available. Best of all, Joomla is an open source solution that is freely available to everyone.  Wordpress: WordPress is web software you can use to create a beautiful website or blog.We like to say thatWordPress is both free and priceless at the same time.  Drupal: Come for the software, stay for the community Drupal is an open source content management platform powering millions of websites and applications. It’s built, used, and supported by an active and diverse community of people around the world. JAB-2014 © Joomlapolis - 2014 9
  • What some public trend sites show Someone looking to compare CMS’s might look at public sites that display usage trends JAB-2014 © Joomlapolis - 2014 10
  • Usage trends (http://trends.builtwith.com/cms) JAB-2014 © Joomlapolis - 2014 11
  • Wordpress trends (http://trends.builtwith.com/cms) JAB-2014 © Joomlapolis - 2014 12 Disclaimer: These graphs are publicly available and their accuracy cannot be verified. The author does not endorse them.
  • Joomla trends JAB-2014 © Joomlapolis - 2014 13 Disclaimer: These graphs are publicly available and their accuracy cannot be verified. The author does not endorse them.
  • Drupal trends JAB-2014 © Joomlapolis - 2014 14 Disclaimer: These graphs are publicly available and their accuracy cannot be verified. The author does not endorse them.
  • Agree or disagree  Whether these stats are real or not, it doesn’t matter.  What does matter is that we as a project understand that they are publicly available and we need to address them.  Joomla marketing is aware of these and is addressing them. JAB-2014 © Joomlapolis - 2014 15
  • Real (?) targets  John Coonen ( http://www.cmsconnection.com ) quote: PRIMARY MARKETS OFTHE BIG 3 (there is overlap, of course, but their big target):  WordPress Market: End Users  Joomla Market: Users of 3rd Party Products & Services  Drupal Market: Developers & Digital Agencies JAB-2014 © Joomlapolis - 2014 16
  • niche markets  K2 powered news portals  Joomla CLI framework, platform or whatever its called  We need more niche market exposure Why not documentation sites ? JAB-2014 © Joomlapolis - 2014 17
  • Documentation dilemma  Ask yourself: How many Joomla projects actually use Joomla for their online documentation?  Why not? --- What’s missing?  Even better: Does the Joomla project use Joomla for its online documentation?  Why not?  Slightly off-topic: Why doesn’t Joomla use Kunena to power its forums?  If there are features missing we can add them! JAB-2014 © Joomlapolis - 2014 18
  • Joomlapolis experience  CB Documentation  MS Word  PDF  Pros: easy to create great content  Cons: manual release process, versioning wows  CBSubs Documentation  MS Word  PDF  Tutorials  Joomla articles  Pros: easy to create using better editor (JCE)  Cons: no versioning (prior to J3.2), no commenting JAB-2014 © Joomlapolis - 2014 19
  • Our long list requirements  Online  Pay-wall  Versioning  Source control  Commenting  Tagging  References  Cross referencing  PDF generation  Multiple authors / Collaboration  Localization  Exporting to other formats  Table of contents  Table of figures  Glossary  Flexible layouts  Social sharing  Contributions / workflows JAB-2014 © Joomlapolis - 2014 20
  • Some existing general solutions  Wiki based solutions  Alfresco  Liferay  Calenco  XML-based tools  Confluence (not open-source)  MadCap (not open-source) JAB-2014 © Joomlapolis - 2014 21
  • Guess what? It appears that there is no defacto solution for general documentation projects JAB-2014 © Joomlapolis - 2014 22
  • Strategic decision Use Joomla for our documentation projects Identify must-haves and nice-to-haves Prioritize missing features Contribute, develop, push for improvements JAB-2014 © Joomlapolis - 2014 23
  • Must-have features – Joomla functionality Must-have feature Initial Joomla functionality WYSIWYG editor Default editors or even better JCE Online presentation Article layouts Flexible Menu generation from cat tree Third party? PDF generation Third party? Table of contents Category listings Versioning Article versioning Pay-wall Integration with CBSubs Tagging Joomla Tags Commenting Third-party solutions ? Social sharing Third-party solutions ? Cross referencing Joomla Tags ? JAB-2014 © Joomlapolis - 2014 24
  • High priority nice-to-have Nice-to-have feature Solution Collaboration Joomla ACL ? Localization Joomla Language support ? Source control integration ? Exporting to other formats ? Contributions workflow Joomla article submission workflow? Table of figures ? Glossary ? JAB-2014 © Joomlapolis - 2014 25
  • What are your needs ?  To help make Joomla a better tool for documentation projects please complete this form: goo.gl/UZ3RpY JAB-2014 © Joomlapolis - 2014 26
  • WIP: Content category structure JAB-2014 © Joomlapolis - 2014 27
  • More WIP: Articles JAB-2014 © Joomlapolis - 2014 28
  • More Default Joomla look JAB-2014 © Joomlapolis - 2014 29
  • More Experimenting with third-party ext. JAB-2014 © Joomlapolis - 2014 30
  • More Experimenting with third-party ext. JAB-2014 © Joomlapolis - 2014 31
  • Way forward  Need to form an informal team of Joomla users interested in exploring the use of Joomla for their online documentation needs  Need to identify (if possible) or develop:  Menu generation tool from content category tree  Commenting solution  Social sharing solution  PDF export for content category tree  Whatever else informal team deems appropriate JAB-2014 © Joomlapolis - 2014 32
  • Lets work together!  To help make Joomla a better tool for documentation projects please complete this form: goo.gl/UZ3RpY JAB-2014 © Joomlapolis - 2014 33
  • More Online questionnaire p1 JAB-2014 © Joomlapolis - 2014 34
  • More Online questionnaire p2 JAB-2014 © Joomlapolis - 2014 35
  • More Online questionnaire p3 JAB-2014 © Joomlapolis - 2014 36
  • More Online questionnaire p4 JAB-2014 © Joomlapolis - 2014 37
  • More Online questionnaire p5 JAB-2014 © Joomlapolis - 2014 38
  • More Next steps  Gather and process form data  Notify interested people (via email and maybe skype chat)  Start exchanging experiences  Collect a list of third-party extensions that make Joomla better for documentation projects  Identify improvements needed in Joomla  Identify need for new features or new Joomla add-ons  Continuous feedback to community (JCM articles?) JAB-2014 © Joomlapolis - 2014 39
  • More Thank you JAB-2014 © Joomlapolis - 2014 40 I am Nicholas (Nick) Antimisiaris (aka nant on forums) Member of the Community Builder team Nant @ Joomlapolis.com and I LOVE Joomla! Google form: goo.gl/UZ3RpY Slides: www.slideshare.net/cbtea m