The Joomla! Forum ™

Download

Demo


Board index » Joomla! Official Sites & Infrastructure » Documentation - Feedback/Information/Suggestions

Forum rules


Please click here to view the forum rules



Post new topic Reply to topic  Page 1 of 1
  [ 21 posts ] 
  Print view Previous topic | Next topic 
Author Message
Chris Davenport
PostPosted: Mon Dec 31, 2007 10:17 pm 
User avatar
Joomla! Ace
Joomla! Ace

Joined: Thu Aug 18, 2005 8:57 am
Posts: 1376
Location: Shrewsbury, Shropshire, United Kingdom
The first Joomla! Doc Camp will take place soon.

If you have any ideas about particular topics you would like to see documented, please add a description of what you'd like to see here.

Thanks,
Chris.

_________________
Joomla Leadership Team - Production Working Group

Joomla Web Services http://www.kickstarter.com/projects/964120480/joomla-web-services
Lion Coppice http://www.lioncoppice.org
Top
 Profile  
 
DanBollinger
PostPosted: Tue Jan 01, 2008 12:33 am 
Joomla! Intern
Joomla! Intern

Joined: Fri Aug 17, 2007 11:18 pm
Posts: 84
Is there a table of contents or browse feature for the wiki? I'm having problems navigating it without resorting to random pages, a search, or tags. Dan
Top
 Profile  
 
Chris Davenport
PostPosted: Tue Jan 01, 2008 12:55 am 
User avatar
Joomla! Ace
Joomla! Ace

Joined: Thu Aug 18, 2005 8:57 am
Posts: 1376
Location: Shrewsbury, Shropshire, United Kingdom
All currently available information on the Doc Camp is on this page: http://docs.joomla.org/index.php?title=Joomla%21_Doc_Camp

We're starting to put together a list of tasks on this page: http://docs.joomla.org/index.php?title=Doc_Campers_Start_Here

Regards,
Chris.

_________________
Joomla Leadership Team - Production Working Group

Joomla Web Services http://www.kickstarter.com/projects/964120480/joomla-web-services
Lion Coppice http://www.lioncoppice.org
Top
 Profile  
 
severdia
PostPosted: Tue Jan 01, 2008 6:44 pm 
User avatar
Joomla! Guru
Joomla! Guru

Joined: Mon May 01, 2006 4:34 pm
Posts: 526
A while back, Macromedia put together a site called Pet Market where they showcased many popular features of their products all in one mock site. Then they developed a ton of case studies and tutorials around how users/developers could create the same functionality, etc.

http://www.adobe.com/devnet/blueprint/

What do you think about a series of tutorials (falling into the User/Admin/Web Designer categories) that would take a mock Joomla site and break down how easy it is to put together using step-by-step instructions?

_________________
Joomla Leadership Team
Author of Using Joomla from O'Reilly Media. | http://www.usingjoomlabook.com/
Creative Director, Kontent Design http://www.kontentdesign.com
Top
 Profile  
 
hotnuts21
PostPosted: Tue Jan 01, 2008 11:14 pm 
User avatar
Joomla! Explorer
Joomla! Explorer

Joined: Wed Aug 17, 2005 11:11 pm
Posts: 315
For future reference, with a bit more forward warning I could put together a location for the UK. We have all the facilities available to do this. I *MAY* be able to get something organised before the 19th if someone can get in touch with me, but cannot guarantee it.

Incidently it will be based in Aberystwyth, Wales UK.



thnkx
Paul
Top
 Profile  
 
Chris Davenport
PostPosted: Wed Jan 02, 2008 12:01 am 
User avatar
Joomla! Ace
Joomla! Ace

Joined: Thu Aug 18, 2005 8:57 am
Posts: 1376
Location: Shrewsbury, Shropshire, United Kingdom
severdia wrote:
What do you think about a series of tutorials (falling into the User/Admin/Web Designer categories) that would take a mock Joomla site and break down how easy it is to put together using step-by-step instructions?

I like the idea.  It would take a bit of planning to make it work, but definitely one for the list.

Thanks,
Chris.

_________________
Joomla Leadership Team - Production Working Group

Joomla Web Services http://www.kickstarter.com/projects/964120480/joomla-web-services
Lion Coppice http://www.lioncoppice.org
Top
 Profile  
 
Chris Davenport
PostPosted: Wed Jan 02, 2008 12:50 am 
User avatar
Joomla! Ace
Joomla! Ace

Joined: Thu Aug 18, 2005 8:57 am
Posts: 1376
Location: Shrewsbury, Shropshire, United Kingdom
hotnuts21 wrote:
For future reference, with a bit more forward warning I could put together a location for the UK. We have all the facilities available to do this. I *MAY* be able to get something organised before the 19th if someone can get in touch with me, but cannot guarantee it.

Incidently it will be based in Aberystwyth, Wales UK.

Sorry about the short notice.  If this event is successful we will probably run another later in the year and we'll be able to give more notice for that.  If you can put something together for the 19th that would be great.  Sending you a PM.

Regards,
Chris.

_________________
Joomla Leadership Team - Production Working Group

Joomla Web Services http://www.kickstarter.com/projects/964120480/joomla-web-services
Lion Coppice http://www.lioncoppice.org
Top
 Profile  
 
DesignGuy
PostPosted: Wed Jan 02, 2008 2:31 am 
User avatar
Joomla! Explorer
Joomla! Explorer

Joined: Sat Sep 02, 2006 9:33 pm
Posts: 258
Location: Chicago, USA
We can work on a Chicago location for an upcoming event.

_________________
John Coonen
Director, CMS Association
JoomlaChicago User Group - http://joomlachicago.com
CMS Expo - http://www.CMSX.us
Top
 Profile  
 
AmyStephen
PostPosted: Wed Jan 02, 2008 3:02 am 
Joomla! Champion
Joomla! Champion

Joined: Wed Nov 22, 2006 3:35 pm
Posts: 6927
Location: Nebraska
Chris -

I might have missed this on the wiki, but is there a place for those intending to participate to sign up? Particularly, if there is not a physical location? Or, even if we want to offer a physical location if others in our area are interested?

Thanks for this great idea and way for us to participate,
Amy :)

_________________
http://Twitter.com/AmyStephen
http://www.alltogetherasawhole.org/
Top
 Profile  
 
yma981
PostPosted: Wed Jan 02, 2008 9:45 am 
Joomla! Apprentice
Joomla! Apprentice

Joined: Tue Nov 13, 2007 12:22 pm
Posts: 5
Hello Joomla!'s Heroes

I have a suggestion for you. Why don't you try to build a comprehensive Walkthrough that takes new comers like me in the whole process of building, optimizing a website (a real example) and learning the multiple joomla fields (templates, backend, frontend, components, modules etc...).

Thank you
Reagrds
YMA


Mod note: Manual signature removed. Please add signatures in your profile and not to each post.

_________________
YMA
-------
http://www.alameddine.org


Last edited by brad on Fri Jan 25, 2008 12:11 am, edited 1 time in total.

Top
 Profile  
 
Chris Davenport
PostPosted: Wed Jan 02, 2008 4:05 pm 
User avatar
Joomla! Ace
Joomla! Ace

Joined: Thu Aug 18, 2005 8:57 am
Posts: 1376
Location: Shrewsbury, Shropshire, United Kingdom
DesignGuy wrote:
We can work on a Chicago location for an upcoming event.

That would be cool.  Let me know if there's anything we can do to help.

Regards,
Chris.

_________________
Joomla Leadership Team - Production Working Group

Joomla Web Services http://www.kickstarter.com/projects/964120480/joomla-web-services
Lion Coppice http://www.lioncoppice.org
Top
 Profile  
 
Chris Davenport
PostPosted: Wed Jan 02, 2008 4:16 pm 
User avatar
Joomla! Ace
Joomla! Ace

Joined: Thu Aug 18, 2005 8:57 am
Posts: 1376
Location: Shrewsbury, Shropshire, United Kingdom
AmyStephen wrote:
I might have missed this on the wiki, but is there a place for those intending to participate to sign up? Particularly, if there is not a physical location? Or, even if we want to offer a physical location if others in our area are interested?

You just need to register on the wiki (here's a quick link: http://docs.joomla.org/index.php?title=Special:Userlogin&type=signup).  As an anti-spam measure you need a valid email address to complete the registration process.  That gives you write access to the wiki.

If you wish to be present at one of the physical locations you need to visit the appropriate website and register there as these events are being run by local community members.  Right now only Vancouver has that facility, but others will follow soon.

If you want to offer a physical location you don't need to do anything special (except organise it!) but it makes sense to let me have the details so I can help spread the word!  That includes being listed in the official announcements.

Chris.

_________________
Joomla Leadership Team - Production Working Group

Joomla Web Services http://www.kickstarter.com/projects/964120480/joomla-web-services
Lion Coppice http://www.lioncoppice.org
Top
 Profile  
 
Chris Davenport
PostPosted: Wed Jan 02, 2008 4:24 pm 
User avatar
Joomla! Ace
Joomla! Ace

Joined: Thu Aug 18, 2005 8:57 am
Posts: 1376
Location: Shrewsbury, Shropshire, United Kingdom
yma981 wrote:
I have a suggestion for you. Why don't you try to build a comprehensive Walkthrough that takes new comers like me in the whole process of building, optimizing a website (a real example) and learning the multiple joomla fields (templates, backend, frontend, components, modules etc...).

Yeah, I think that's a good idea.  It sounds a lot like severdia's suggestion earlier in this thread where we have one or more sample/demo sites setup then we write tutorials which take the reader step-by-step through the process used to create them.  I think it could work although it would require quite a bit of upfront planning.  Is that the kind of thing you had in mind?

Regards,
Chris.

_________________
Joomla Leadership Team - Production Working Group

Joomla Web Services http://www.kickstarter.com/projects/964120480/joomla-web-services
Lion Coppice http://www.lioncoppice.org
Top
 Profile  
 
Jonathan Cameron
PostPosted: Sat Jan 19, 2008 4:42 am 
Joomla! Apprentice
Joomla! Apprentice

Joined: Wed Sep 12, 2007 7:55 pm
Posts: 31
Location: Pasadena, California
Here are few things I would see better documentation for:

  - More details about how to create a editors-xtd plugin.  For instance, once you are in
    the onDisplay call-back code, how can you get the article id?  How do you surpress
    the display of your button dynamically (I figured this one out).  How can you
    display something above or below the article editing area?

  - How to construct a patch file (assuming this is possible):  A file that you upload through
    the install/uninstall extensions system that would replace an existing file with an updated
    version.  This would simplify creating patches for existing extensions that only require
    that files be modified.

  - Better documentation of the various types of things that can be done via custom
    plugins.

Thanks!

    -Jonathan
Top
 Profile  
 
Chris Davenport
PostPosted: Sat Jan 19, 2008 9:58 am 
User avatar
Joomla! Ace
Joomla! Ace

Joined: Thu Aug 18, 2005 8:57 am
Posts: 1376
Location: Shrewsbury, Shropshire, United Kingdom
Jonathan Cameron wrote:
... once you are in the onDisplay call-back code, how can you get the article id?

Sounds like a job for JFactory.  Writing about JFactory is on the task list.  If you find answers to your questions (and I don't know the answers), perhaps you could write up some notes that might form the basis of some documentation.

Jonathan Cameron wrote:
  - How to construct a patch file (assuming this is possible):  A file that you upload through
    the install/uninstall extensions system that would replace an existing file with an updated
    version.  This would simplify creating patches for existing extensions that only require
    that files be modified.

Upgrading of extensions is not supported in 1.5, although I believe some hooks are there for future use.  Hopefully someone will write a white paper proposal for this so we can get it into a future version of Joomla!

Jonathan Cameron wrote:
  - Better documentation of the various types of things that can be done via custom
    plugins.

Write ups for most of the plugin types are already on the Doc Camp task list.  Just need to find the authors to write them. :)

Thanks for you comments.  We'll try to make it happen.

Regards,
Chris.

_________________
Joomla Leadership Team - Production Working Group

Joomla Web Services http://www.kickstarter.com/projects/964120480/joomla-web-services
Lion Coppice http://www.lioncoppice.org
Top
 Profile  
 
avdkooij
PostPosted: Mon Jan 21, 2008 10:04 pm 
Joomla! Apprentice
Joomla! Apprentice

Joined: Thu Dec 29, 2005 8:31 pm
Posts: 45
maybe a usefull suggestion:

Categorize all wiki-pages in either "end-user documentation" or "developer documentation".
- End-user documentation would be used as input for all documentation found on help.joomla.org, the help screens in the joomla-site administrating back-end, etc.
- Developer documentation would be placed at dev.joomla.org, for those designing /coding third party extensions (templates, modules, components) and/or the joomla core.

I expect documentation for these two groups, differs a lot in e.g. learning curve, writing style etc.
If usefull, i am willing to help categorizing the current pages in de wiki...


Last edited by avdkooij on Mon Jan 21, 2008 10:05 pm, edited 1 time in total.

Top
 Profile  
 
Chris Davenport
PostPosted: Thu Jan 24, 2008 1:50 am 
User avatar
Joomla! Ace
Joomla! Ace

Joined: Thu Aug 18, 2005 8:57 am
Posts: 1376
Location: Shrewsbury, Shropshire, United Kingdom
Hi avdkooij,

Actually we are deliberately going in the opposite direction at the moment by blurring the previous distinction between user and developer documentation.  That's because we have found that there is quite a bit of overlap with some user documentation being of use to developers and vice versa.  Consequently we are gradually centralising the documentation and we will also be trying to modularise it so that it becomes more re-usable.  We can still retain user/developer tags in the form of wiki "categories", but these are more like hints than hard-and-fast divisions.

This does not mean that we will be doing away with help.joomla.org or dev.joomla.org, but it is likely that the documentation areas that they contain will be derived from the central docs.joomla.org instead of being "original".

If you want to help us in the documentation effort, then please register on docs.joomla.org and get started on any task that takes your fancy. :)

Regards,
Chris.

_________________
Joomla Leadership Team - Production Working Group

Joomla Web Services http://www.kickstarter.com/projects/964120480/joomla-web-services
Lion Coppice http://www.lioncoppice.org
Top
 Profile  
 
avdkooij
PostPosted: Thu Jan 24, 2008 10:14 pm 
Joomla! Apprentice
Joomla! Apprentice

Joined: Thu Dec 29, 2005 8:31 pm
Posts: 45
great to see that the doc group is approaching Joomla's documentation in such a professional way. Tactics for handling the user / developer overlap, the modulated documentation, etc. You guys are doing an amazing job!
Top
 Profile  
 
radiant_tech
PostPosted: Tue Jan 29, 2008 9:29 am 
User avatar
Joomla! Guru
Joomla! Guru

Joined: Sat Dec 15, 2007 3:02 pm
Posts: 531
Location: Washington DC Metro
After reading the existing MVC tutorials (J! 1.5), I still needed to clarify the file structure and naming conventions of such a component.  I tried to add this to the Doc Camp list, but apparently used an "impossibly long title".  :-[  True enough.  However, the page has been redirected simply to "Naming Conventions", a title I don't believe is wholly appropriate either.

I've added {{review}} to the top of the page -- so I'm hoping this will be categorized more correctly.  Is there another, better way I should have gone about this?  Another location or forum thread where I could have asked for help with a more appropriate title?

While I'm happy to continue to contribute to documenting 1.5, this was rather like having a door slammed in your face and left wondering where to go next.

Thanks.

_________________
Catch up with me on Google+: https://plus.google.com/106742096640193690159
Top
 Profile  
 
Chris Davenport
PostPosted: Tue Jan 29, 2008 4:37 pm 
User avatar
Joomla! Ace
Joomla! Ace

Joined: Thu Aug 18, 2005 8:57 am
Posts: 1376
Location: Shrewsbury, Shropshire, United Kingdom
Hi radiant_tech,

Apologies if you felt like we were slamming a door in your face.  There will likely be a lot of changing of titles, moving stuff around, breaking things into smaller modules, etc., to come.  The contents of the wiki are pretty haphazard at the moment, following the Doc Camp event, and we need to develop a structure and get stuff organised into that structure.  Please don't be offended if that happens to something you've written.  It's nothing personal.

Thank you for taking the time to contribute to the project.  We really do appreciate such efforts.

Regards,
Chris.

_________________
Joomla Leadership Team - Production Working Group

Joomla Web Services http://www.kickstarter.com/projects/964120480/joomla-web-services
Lion Coppice http://www.lioncoppice.org
Top
 Profile  
 
TSX-Today
PostPosted: Tue Mar 19, 2013 8:05 pm 
Joomla! Apprentice
Joomla! Apprentice

Joined: Wed Dec 19, 2012 6:56 pm
Posts: 27
Location: Toronto, Canada
Will there be something like this for the new versions? Thanks

_________________
SEO in Vancouver: http://www.SEOinVancouver.com
TSX Today: http://www.TSX-Today.com
Top
 Profile  
 
Display posts from previous:  Sort by  
Post new topic Reply to topic  Page 1 of 1
  [ 21 posts ] 


Board index » Joomla! Official Sites & Infrastructure » Documentation - Feedback/Information/Suggestions

Who is online

Users browsing this forum: No registered users and 8 guests

You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot post attachments in this forum

Jump to:  
Powered by phpBB® Forum Software © phpBB Group