Joomla! Discussion Forums



It is currently Mon Nov 23, 2009 7:22 pm (All times are UTC )

 





Post new topic Reply to topic  [ 4 posts ] 
Author Message
Posted: Sat Dec 01, 2007 3:22 pm 
User avatar
Joomla! Champion
Joomla! Champion
Offline

Joined: Thu Aug 18, 2005 8:43 pm
Posts: 5759
Location: New York
I'm so impressed with what everyone has been doing.


If you are writing documentation tasks, some good things to do are:

1. Have someone help you with proof reading. I love the way people here on this forum are helping each other with this.

2. Test your documentation on someone. Ask the person to try to follow the  instructions and tell you where they are unclear.

3. By all means share your work here and elsewhere in the forums and get feedback.

4. The page lengths in the tasks are approximate except for the tri-folds. If you need more pages that is fine.

It's hard, but it is part of the process of writing good documentation to incorporate or at least cosider comments you are given.

_________________
Read your words before posting and think about how other people will read them.
Be polite. Be kind. Be constructive. Say thank you.
Freedom-Equality-Trust-Community-Collaboration-Usability
http://opensourcematters.org/index.php?Itemid=134


Last edited by mcsmom on Sat Dec 01, 2007 3:27 pm, edited 1 time in total.

Top
   
 
Posted: Sun Dec 09, 2007 2:29 am 
User avatar
Joomla! Explorer
Joomla! Explorer
Offline

Joined: Sat Sep 09, 2006 6:48 pm
Posts: 422
Location: Velika Greda, Serbia
I finished my task before two day's but i don't have any feedback from members of community. I don't know how is my work? And i will jump on other task if this is ok.

Task # 109

Tnx anyway :)

_________________
http://www.twitter.com/baneweb
http://www.brankopajic.com | Blog o web trendovima!


Top
   
 
Posted: Sun Dec 09, 2007 12:42 pm 
User avatar
Joomla! Explorer
Joomla! Explorer
Offline

Joined: Thu Nov 29, 2007 9:37 pm
Posts: 403
Location: Minnesota, USA
I have a quick question about punctuation.
If Joomla! is at the end of a sentence, should there be a period after Joomla! or not?  Seeing "Joomla!." just seems strange to me.

Thanks!

_________________
Leonard Bernstein for President -
    Web Development Services:
          www.BernsteinForPresident.com
My Software Freedom Blog:
          Trombonechamp.Wordpress.com


Top
   
 
Posted: Sun Dec 09, 2007 2:58 pm 
User avatar
Joomla! Champion
Joomla! Champion
Offline

Joined: Wed Nov 22, 2006 3:35 pm
Posts: 6420
Location: Nebraska
Balvanboy - I am walking through each of the tasks this weekend and am up to 58. So, it will be a little bit, but I will review your work. Thanks for your patience.

TromboneChamp -

That is an excellent question. It was discussed a year ago, or so, by the documentation team and determined that, yes, we should include all forms of punctuation following the word Joomla!, with the *exception* of the exclamation point.

Of course, the exception to the exception is that additional exclamation points are required when stating ones love of Joomla!. So, it is not permitted to state "I want to build hundreds of sites using Joomla!!" but it is permitted to state "I love Joomla!!!!!"

Make sense?

Truthfully, you get used to it. Sadly, your writing becomes infected with an abundance of exclamation points and people accuse you of being a cheerleader. When you recognize that means they perceive you as positive, it's easy to see that the Joomla! project is responsible for spreading good vibes all over the planet! <-- see what I mean?

Have fun,
Amy :)

_________________
http://Twitter.com/AmyStephen
Unofficial Joomla Developer and Site Builders Network http://AllTogetherAsAWhole.org


Top
   
 
Display posts from previous:  Sort by  
Post new topic Reply to topic  [ 4 posts ] 

Quick reply

 



Who is online

Users browsing this forum: No registered users and 2 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 © 2000, 2002, 2005, 2007 phpBB Group