106 - Write a document explaining how to use core Joomla! functions for a si

Google's Highly Open Participation Program tries to get young students into Open Source and Joomla! specifically. Everyone is welcome, there are not limits. You can be a coder, documenter, tester, translator to help out. Jump in and start helping!
Locked
SharifOerton
Joomla! Apprentice
Joomla! Apprentice
Posts: 17
Joined: Mon Dec 03, 2007 1:01 am

106 - Write a document explaining how to use core Joomla! functions for a si

Post by SharifOerton » Mon Dec 03, 2007 1:06 am

Greetings - this is my first task in this contest, and I hope to have it finished soon, however I have a question - which format should the final submission be in? PDF or HTML?

Thanks,
Sharif

Claimed: Dec 2 Due: Dec 16
Mod Note: Added task description
Write a document explaining how to use core Joomla! functions for a simple
photo gallery or portfolio.
Description

For this task you will help beginning users move beyond the basics to take
advantage of the flexibility of Joomla!.

Users often wish to display photos, artwork or other images on their sites.
The Joomla! content component combined with the media manager can be used
to create a simple display of these works. An example of this can be seen
at http://shop.joomla.org/.

Create a one to two page document that describes the steps for doing this
in Joomla! 1.5.
Skills Needed

    * Familiarity with Joomla!
    * Good writing skills
    * Good page layout skills

Difficulty

Basic
Work Product

A one page polished document that effectively explains the process to a
beginning user.
Licensing

Documentation written for this task must be made available under the
Joomla! Electronic Documentation License.
Extra Credit (optional)

Create a second document that explains how to use the caption, description
and rating features of Joomla! to enhance their galleries.
Time Limit

Two weeks

Google Task

[me=AmyStephen]Changed subject slightly for sorting all threads to match against Google resource  :)[/me]
Last edited by AmyStephen on Wed Dec 12, 2007 6:41 am, edited 1 time in total.

fervidfrogger
Joomla! Apprentice
Joomla! Apprentice
Posts: 9
Joined: Sun Jul 29, 2007 6:37 pm

Re: 106 - Write a document explaining how to use core Joomla! functions for a si

Post by fervidfrogger » Mon Dec 03, 2007 2:29 am

I think the main document format that should be used is .odt using OpenOffice, since it's the easiest to edit across multiple platforms.

SharifOerton
Joomla! Apprentice
Joomla! Apprentice
Posts: 17
Joined: Mon Dec 03, 2007 1:01 am

Re: 106 - Write a document explaining how to use core Joomla! functions for a si

Post by SharifOerton » Mon Dec 03, 2007 2:32 am

Okay, gotcha, thanks.

SharifOerton
Joomla! Apprentice
Joomla! Apprentice
Posts: 17
Joined: Mon Dec 03, 2007 1:01 am

Re: 106 - Write a document explaining how to use core Joomla! functions for a si

Post by SharifOerton » Mon Dec 03, 2007 3:36 am

Okay, first draft is complete - any suggestions for improvement before I submit it on the Google page?

Link

Thanks in advance.

AmyStephen
Joomla! Champion
Joomla! Champion
Posts: 7018
Joined: Wed Nov 22, 2006 3:35 pm
Location: Nebraska
Contact:

Re: 106 - Write a document explaining how to use core Joomla! functions for a si

Post by AmyStephen » Tue Dec 04, 2007 6:15 am

Sharif -

Your document is entitled Creating an Image Gallery in Joomla! 1.5, but you are not using Joomla! v 1.5. Instead, you are using the older Joomla! v 1.0.x version. Please look at the Help button, above, and follow the links to the installation guide that Humvee put together. It will help you install the newest release. The guide must be about the Joomla! v 1.5 version.

Thanks!
Amy :)

SharifOerton
Joomla! Apprentice
Joomla! Apprentice
Posts: 17
Joined: Mon Dec 03, 2007 1:01 am

Re: 106 - Write a document explaining how to use core Joomla! functions for a si

Post by SharifOerton » Tue Dec 04, 2007 6:19 am

Ah, right, okay, thank you. I thought that I had installed the latest version - evidently. not. I'll rewrite it now.

AmyStephen
Joomla! Champion
Joomla! Champion
Posts: 7018
Joined: Wed Nov 22, 2006 3:35 pm
Location: Nebraska
Contact:

Re: 106 - Write a document explaining how to use core Joomla! functions for a si

Post by AmyStephen » Tue Dec 04, 2007 6:28 am

If you have questions, do not hesitate to ask!

Thanks,
Amy :)

SharifOerton
Joomla! Apprentice
Joomla! Apprentice
Posts: 17
Joined: Mon Dec 03, 2007 1:01 am

Re: 106 - Write a document explaining how to use core Joomla! functions for a si

Post by SharifOerton » Tue Dec 04, 2007 6:51 am

Okay, I've updated it and uploaded it to the same location the old document was at (http://sharif.oerton.net.au/misc/Joomla ... allery.odt).

Again, please let me know if it can be improved, and sorry about my misunderstanding!

SharifOerton
Joomla! Apprentice
Joomla! Apprentice
Posts: 17
Joined: Mon Dec 03, 2007 1:01 am

Re: 106 - Write a document explaining how to use core Joomla! functions for a si

Post by SharifOerton » Fri Dec 07, 2007 7:35 am

Anyone?

SharifOerton
Joomla! Apprentice
Joomla! Apprentice
Posts: 17
Joined: Mon Dec 03, 2007 1:01 am

Re: 106 - Write a document explaining how to use core Joomla! functions for a si

Post by SharifOerton » Sun Dec 09, 2007 3:42 am

*Bump*

AmyStephen
Joomla! Champion
Joomla! Champion
Posts: 7018
Joined: Wed Nov 22, 2006 3:35 pm
Location: Nebraska
Contact:

Re: 106 - Write a document explaining how to use core Joomla! functions for a si

Post by AmyStephen » Sun Dec 09, 2007 4:06 am

Sharif -

I think this needs work. If you look at the description, above, you see referenced the shop.joomla.org example as one where a gallery was created.

What might be very helpful is to find some freely available images that you can have others go download. Tell them to download these six pictures (or whatever) from this location. (You could even use the shop.joomla.org ones if you want to demonstrate how to build that gallery.)

Then, your document should show each step needed to create a good looking gallery. More step by step instructions with pictures, resulting in a final picture of a gallery.

Also, why not use the Image button to select images? Seems like that would be easier than copying and pasting URLs from the media manager. Or, maybe I am missing something.

A little more detail, I think, and remember how useful this will be, so be encouraged, not discouraged.

Thanks!
Amy :)

SharifOerton
Joomla! Apprentice
Joomla! Apprentice
Posts: 17
Joined: Mon Dec 03, 2007 1:01 am

Re: 106 - Write a document explaining how to use core Joomla! functions for a si

Post by SharifOerton » Sun Dec 09, 2007 4:11 am

Okay Amy, I'll do some more work on it.

Thanks,
Sharif

SharifOerton
Joomla! Apprentice
Joomla! Apprentice
Posts: 17
Joined: Mon Dec 03, 2007 1:01 am

Re: 106 - Write a document explaining how to use core Joomla! functions for a si

Post by SharifOerton » Tue Dec 11, 2007 7:09 am

How's this, Amy? I used the default images built in to Joomla! for the example gallery - is that what you wanted?

Here it is:

http://sharif.oerton.net.au/misc/Joomla ... allery.odt

AmyStephen
Joomla! Champion
Joomla! Champion
Posts: 7018
Joined: Wed Nov 22, 2006 3:35 pm
Location: Nebraska
Contact:

Re: 106 - Write a document explaining how to use core Joomla! functions for a si

Post by AmyStephen » Tue Dec 11, 2007 7:17 pm

I made a few changes; here are my revisions. I got rid of the last big picture since it didn't add a lot. And, with it gone, this is a nice, compact 1-pager (which is helpful) Please review, make changes desired and go ahead and post at Google Code when you are done. Also, post here, too, so that we know you are ready for a last review and we will try to conclude this task ASAP.

Thanks!
Amy :)

SharifOerton
Joomla! Apprentice
Joomla! Apprentice
Posts: 17
Joined: Mon Dec 03, 2007 1:01 am

Re: 106 - Write a document explaining how to use core Joomla! functions for a si

Post by SharifOerton » Tue Dec 11, 2007 8:32 pm

Thank you Amy - I now see the "tone" the task wanted. I've posted it to the Google Code site - the only change I made was to reposition the last image so that it did not obscure the footer.

Thanks a lot for your assistance.

Sharif

Final Document on Google[me=AmyStephen]Added Google Link[/me]
Last edited by AmyStephen on Wed Dec 12, 2007 2:37 am, edited 1 time in total.

AmyStephen
Joomla! Champion
Joomla! Champion
Posts: 7018
Joined: Wed Nov 22, 2006 3:35 pm
Location: Nebraska
Contact:

Re: 106 - Write a document explaining how to use core Joomla! functions for a si

Post by AmyStephen » Wed Dec 12, 2007 6:41 am

Sharif -

Thanks for your contributions! This will be very helpful to a number of people as they share their pictures with others. It turned out nicely - easy one page set of instructions that are not at all intimidating.

Appreciate your work, on behalf of the Joomla! community.

This task is complete.
Amy :)


Locked

Return to “Google's Highly Open Participation Contest”