Admin. 1.5: Intro manual proofread

Your suggestions, modifications and corrections regards the documentation. Your help is important.
Locked
User avatar
nathandiehl
Joomla! Champion
Joomla! Champion
Posts: 6044
Joined: Fri Aug 19, 2005 3:03 pm
Location: Indiana, USA
Contact:

Admin. 1.5: Intro manual proofread

Post by nathandiehl » Mon Jun 26, 2006 5:43 pm

for what it's worth, I got pretty tired of seeing Site (Front-End) and Administrator (Back-end) over and over again. I don't think you need to refer to both names EVERY time. i found that quite annoying to me.

http://help.joomla.org/content/view/1626/196/
inconsistant use of 'open source' and 'Open Source'
also, first line references 'Administrator's Manual' should this be 'Administor Manual'?

http://help.joomla.org/content/view/1627/196/
Under 'How the Manual is Organized', item 4: 'The Apendices' -- the menu item says: 'Apendixes', also, 'Glossary' could be lower case.

Help Screens:
First sentance: missing a terminal point (period) after Joomla!.
last paragraph: first sentance, last word: Manual wouldn't need to be capitalized.

Other Help Resources:
second to last line, under help.joomla.org: Manual again doesn't need to be capitalized.

http://help.joomla.org/content/view/1628/196/
inconsistant use of spacing between sections.
Powerful Extensions: it states: 'Seven default Components are part of the standard Joomla! installation' I would have liked to have seen a list here.
Powerful Extnesions: I think it would also be wise to direct people to a location to find extensions: extensions.joomla.org

http://help.joomla.org/content/view/1629/196/

Overview: #2: should be 'Organize' not 'Organized'
Last edited by nathandiehl on Mon Jun 26, 2006 5:48 pm, edited 1 time in total.
If you're new to Joomla, Please read Anna's Joomla! Tips: http://forum.joomla.org/viewtopic.php?t=5503

http://nathandiehl.com | Find out what makes me tick

User avatar
visionspin
Joomla! Enthusiast
Joomla! Enthusiast
Posts: 183
Joined: Mon Aug 22, 2005 9:35 pm
Location: Pittsburgh, PA
Contact:

Re: Admin. 1.5: Intro manual proofread

Post by visionspin » Mon Jul 10, 2006 9:28 pm

Thanks for the tips!

I agree it is annoying to have Site (Front-end) and Administrator (Back-end) over and over. We have been asked to include it in the first mention of each section and then just refer to Site and Administrator in the remainder of the section.

What is an Administor Manual? I am confused.

User avatar
visionspin
Joomla! Enthusiast
Joomla! Enthusiast
Posts: 183
Joined: Mon Aug 22, 2005 9:35 pm
Location: Pittsburgh, PA
Contact:

Re: Admin. 1.5: Intro manual proofread

Post by visionspin » Mon Jul 10, 2006 9:53 pm

Should it be Appendices or Appendixes? I have seen both used and am not sure which is correct.

User avatar
Michelle Bisson
Joomla! Ace
Joomla! Ace
Posts: 1808
Joined: Fri Aug 12, 2005 12:47 am
Location: Quebec City, Canada
Contact:

Re: Admin. 1.5: Intro manual proofread

Post by Michelle Bisson » Wed Jul 12, 2006 3:09 am

Thanks Nathan, we appreciate your suggestions/comments!
Michelle Bisson, POPcliQ, http://www.popcliq.com
Joomla / OSM Trademarks Team Member

User avatar
visionspin
Joomla! Enthusiast
Joomla! Enthusiast
Posts: 183
Joined: Mon Aug 22, 2005 9:35 pm
Location: Pittsburgh, PA
Contact:

Re: Admin. 1.5: Intro manual proofread

Post by visionspin » Tue Jul 18, 2006 12:19 am

I have made the edits suggested, except those related to the questions still unanswered.

User avatar
Michelle Bisson
Joomla! Ace
Joomla! Ace
Posts: 1808
Joined: Fri Aug 12, 2005 12:47 am
Location: Quebec City, Canada
Contact:

Re: Admin. 1.5: Intro manual proofread

Post by Michelle Bisson » Fri Jul 21, 2006 4:24 am

nathandiehl,

Thanks for your suggestions! I am still working through some of them from the other threads.
Michelle Bisson, POPcliQ, http://www.popcliq.com
Joomla / OSM Trademarks Team Member


Locked

Return to “Suggestions, Modifications & Corrections”