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

Jab2014 - Make Joomla! THE solution for online documentation

  • 1.
    Make Joomla!THE solutionfor online documentation @ JandBeyond 2014
  • 2.
    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
  • 3.
    This presentation isabout Something we can do to help make Joomla better JAB-2014 © Joomlapolis - 2014 3
  • 4.
    Requirements / helpform  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
  • 5.
    Presentation Agenda  Thereal 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
  • 6.
    Motivation (repeating) To helpmake Joomla better JAB-2014 © Joomlapolis - 2014 6
  • 7.
    But what isJoomla, 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
  • 8.
    Competition in theCMS market JAB-2014 © Joomlapolis - 2014 8 www.opensourcecms.com Making Joomla better
  • 9.
    How competition defineitself  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
  • 10.
    What some publictrend sites show Someone looking to compare CMS’s might look at public sites that display usage trends JAB-2014 © Joomlapolis - 2014 10
  • 11.
  • 12.
    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.
  • 13.
    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.
  • 14.
    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.
  • 15.
    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
  • 16.
    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
  • 17.
    niche markets  K2powered 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
  • 18.
    Documentation dilemma  Askyourself: 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
  • 19.
    Joomlapolis experience  CBDocumentation  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
  • 20.
    Our long listrequirements  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
  • 21.
    Some existing generalsolutions  Wiki based solutions  Alfresco  Liferay  Calenco  XML-based tools  Confluence (not open-source)  MadCap (not open-source) JAB-2014 © Joomlapolis - 2014 21
  • 22.
    Guess what? It appearsthat there is no defacto solution for general documentation projects JAB-2014 © Joomlapolis - 2014 22
  • 23.
    Strategic decision Use Joomlafor our documentation projects Identify must-haves and nice-to-haves Prioritize missing features Contribute, develop, push for improvements JAB-2014 © Joomlapolis - 2014 23
  • 24.
    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
  • 25.
    High priority nice-to-have Nice-to-havefeature 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
  • 26.
    What are yourneeds ?  To help make Joomla a better tool for documentation projects please complete this form: goo.gl/UZ3RpY JAB-2014 © Joomlapolis - 2014 26
  • 27.
    WIP: Content categorystructure JAB-2014 © Joomlapolis - 2014 27
  • 28.
    More WIP: Articles JAB-2014 ©Joomlapolis - 2014 28
  • 29.
    More Default Joomla look JAB-2014© Joomlapolis - 2014 29
  • 30.
    More Experimenting with third-partyext. JAB-2014 © Joomlapolis - 2014 30
  • 31.
    More Experimenting with third-partyext. JAB-2014 © Joomlapolis - 2014 31
  • 32.
    Way forward  Needto 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
  • 33.
    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
  • 34.
    More Online questionnaire p1 JAB-2014© Joomlapolis - 2014 34
  • 35.
    More Online questionnaire p2 JAB-2014© Joomlapolis - 2014 35
  • 36.
    More Online questionnaire p3 JAB-2014© Joomlapolis - 2014 36
  • 37.
    More Online questionnaire p4 JAB-2014© Joomlapolis - 2014 37
  • 38.
    More Online questionnaire p5 JAB-2014© Joomlapolis - 2014 38
  • 39.
    More Next steps  Gatherand 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
  • 40.
    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