On Mon, Mar 1, 2010 at 5:21 AM, Karsten Wade <kwade@xxxxxxxxxx> wrote:
> On Sun, Feb 28, 2010 at 11:56:01PM -0600, Sijis Aviles wrote:
>>
>> So I'm following up on this idea. I'm thinking about adding the
>> following to the fp.o/get-help page (below "Written Documentation"
>> section). I'd like to hear some feedback, as I'd like to include this
>> before website text freeze.
>>
>> ---
>> + <h3>${Markup(_('Online Classroom'))}</h3>
>> + <p>${Markup(_('The Fedora IRC Classroom periodically holds
>> classes to help you better use, understand and manage your Fedora
>> installation. See the <a href="%s">Classroom</a> page for
>> +
>> ---
>
> +1 to the idea, just a couple of quick adjustments:
>
> * s/See/Refer to/
> * s/understand/understand,/
> * s/page for/
>
> Like this:
>
> ---
> + <h3>${Markup(_('Online Classroom'))}</h3>
> + <p>${Markup(_('The Fedora IRC Classroom periodically holds
> classes to help you better use, understand, and manage your Fedora
> installation. Refer to the <a href="%s">Classroom</a>
> page.
> +
> ---
>
> (It's not necessary to be able to see in order to use the reference.
> This is a common fix in technical writing. The use of the final comma
> before and/or/but in serial lists is really not optional, otherwise it
> can change the meaning of sentences. Well, at least in the more
> strict American English.)
>
> Although this is a page about getting (v. giving) help, is it worth
> mentioning that the IRC Classroom is also for learning about
> participating in and contributing to the Fedora Project? Or is that
> off-topic for the help page? :)
>
> - Karsten
> --
> name: Karsten 'quaid' Wade, Sr. Community Gardener
> team: Red Hat Community Architecture
> uri: http://TheOpenSourceWay.org/wiki
> gpg: AD0E0C41
>
> --
> websites mailing list
> websites@xxxxxxxxxxxxxxxxxxxxxxx
> https://admin.fedoraproject.org/mailman/listinfo/websites
>
Karsten,
Thank you for revising the text. During my paste, i didn't include all
of the text. I'm attaching the complete diff for that page. We could
add that it can teach on how to participate on the Fedora Project..
that's a good idea.
For simplicity, here's the complete text I currently have:
The Fedora IRC Classroom periodically holds classes to help you better
use, understand, and manage your Fedora installation. Refer to the
<a href="%s">Classroom</a> page for more information on
upcoming classes, and archives of previous class sessions.
Thanks again for reviewing this.
Sijis
diff --git a/fedoraproject.org/data/content/get-help.html b/fedoraproject.org/data/content/get-help.html
index 25376f0..28ee548 100644
--- a/fedoraproject.org/data/content/get-help.html
+++ b/fedoraproject.org/data/content/get-help.html
@@ -9,7 +9,6 @@
<body class="help">
<h2>${Markup(_('Get Help.'))}</h2>
<p>${Markup(_('Being new to Fedora can seem daunting, fortunately there are lots of resources available to help make the transition easy. This page ties together all of the resources a new user might like to make use of, some of which would not be immediately obvious coming from another operating system.'))}</p>
-
<p>${Markup(_('For those who already know about the different methods of getting support, but would like to know about Fedora specific locations, here they are:'))}</p>
<ul>
@@ -22,27 +21,23 @@
<p>${Markup(_('For a full list of all the different ways to communicate with the Fedora Project, see this <a href="http://fedoraproject.org/wiki/Communicate">page</a>.'))}</p>
<h3>${Markup(_('Real Time Support (IRC)'))}</h3>
-
<p>${Markup(_('If a problem requires real time support, with somebody to explain each step and deal with any problems as they arise, Internet Relay Chat (IRC) is the ideal solution. Fedora has a number of IRC channels, and one specifically aimed at end-user support.'))}</p>
-
<p>${Markup(_('To access this support launch Fedoras default instant messaging client, Pidgin, and choose Manage from the Accounts menu. Add a new account, and select IRC as the protocol. Next, enter a Screen Name and save the changes. The final step is to add the #fedora channel by selecting Add Chat from the Buddies menu. Make sure to select an IRC account from the drop down menu, and enter #fedora as the channel, clicking Add to save the changes. Now that this is done, #fedora should appear in the default Pidgin screen, and double clicking this will allow you to access the #fedora channel, where end-users can ask questions and get support in real time.'))}</p>
<h3>${Markup(_('E-mail Support'))}</h3>
-
<p>${Markup(_('Some users prefer to take advantage of mailing lists to get help. The advantage of this method is that by subscribing to a mailing list it is possible to discover common problems many users have, and their solutions, before even encountering them! It also makes it easy to see when someone else needs help, and if you know the answer, to help them.'))}</p>
-
<p>${Markup(_('The mailing list for end-user support with Fedora is <a href="http://lists.fedoraproject.org/mailman/listinfo/users">users</a> and can be subscribed to by following that link.'))}</p>
<h3>${Markup(_('Forum Support'))}</h3>
-
<p>${Markup(_('A forum works in a similar manner to a mailing list, but instead of having messages sent to an e-mail address, they are posted to a website that anybody can read. Fedora has officially endorsed the community run <a href="http://fedoraforum.org/">Fedora Forum</a>, and it is an excellent resource for any questions about Fedora.'))}</p>
<h3>${Markup(_('Written Documentation'))}</h3>
-
<p>${Markup(_('Fedora also has a team of talented writers who work hard to produce excellent written documentation. There are a number of different documents available, including the Fedora User Guide, aimed at basic day to day operation of Fedora, an Installation Guide, and Security and SELinux guides.'))}</p>
-
<p>${Markup(_('These guides are available at <a href="http://docs.fedoraproject.org">docs.fedoraproject.org</a>.'))}</p>
+ <h3>${Markup(_('Online Classroom'))}</h3>
+ <p>${Markup(_('The Fedora IRC Classroom periodically holds classes to help you better use, understand, and manage your Fedora installation. Refer to the <a href="%s">Classroom</a> page for more information on upcoming classes, and archives of previous class sessions.' % 'https://fedoraproject.org/wiki/Communicate/IRC/Classroom'))}</p>
+
</body>
</html>
--
websites mailing list
websites@xxxxxxxxxxxxxxxxxxxxxxx
https://admin.fedoraproject.org/mailman/listinfo/websites
