[pydotorg-www] Updates to Jobs HowTo page

[Martin Thomas]

On Jul 21, 2010, at 4:17 PM, David Goodger wrote:

> I just noticed this while cleaning up my inbox, missed it when it
> arrived, sorry.
> 
> On Wed, Jul 14, 2010 at 12:44, Martin Thomas <martin at martinthomas.net> wrote:
>> 
>> On Wed, Jul 14, 2010 at 10:43 AM, David Goodger <goodger at python.org> wrote:
>>> 
>>> On Wed, Jul 14, 2010 at 10:37, Martin Thomas <martin at martinthomas.net>
>>> wrote:
>>>> I have made a number of changes to the jobs howto page
>>>> (http://www.python.org/community/jobs/howto/):
>>> 
>>> And I made some further improvements.
>> 
>> Thanks.
>>> 
>>> I note that your changes put more text up-front. This discussed a
>>> while back, and IIRC we agreed that this would have the effect of
>>> fewer people getting to the most important part: the template. It will
>>> be interesting to see what effect these changes have.
>> 
>> I took advantage of the fact that the template viewed on the webpage is
>> in a highlighted block. In addition to adding some text, I also trimmed a
>> little.  I wanted to remove the volunteer paragraph.. do we really need that
>> on both pages?
> 
> I think that point needs more emphasis, not less. I'm tired of seeing
> reminders from impatient job posters. But it's near the end, so I
> doubt many will make it to that point in the instructions. If anything
> needs to be up-front and boldfaced, it's that.
I completely agree.. except the "volunteer paragraph" I was referring to is the
second paragraph on the page that talk about looking at the wiki.  You are talking
about "life gets in the way" paragraph that closes the page.. which, incidentally, I 
don't think I touched.  

How about we remove the text about finding volunteer positions (as I originally
intended to say) and move the closing paragraph to second position?
Also, put a note in the auto-responder message if it is not there already?

Just my 2c. I am trying to make it clearer for the careful poster.  What would really 
help is some way for the posters who cannot or will not grok RST to fill in the 
template.

Regards // M
 
> 
> -- David
> 
>> Based on the postings recently, people who make it to this page have
>> little trouble finding the template but needed some help with filling it
>> in.
>> Hopefully, the  changes will help there and save some rework.
>> 
>>> 
>>>> Does anyone know why the bullet points after the template are indented?
>>>> It
>>>> is not a CSS issue, as far as I can tell.
>>> 
>>> Do you mean the numbered list? Item 1 was not properly indented, so it
>>> didn't show up as a true HTML "list item" (it was just a paragraph
>>> with "1." at the beginning; fixed now). Items 2 and up were properly
>>> indented, and showed up as list items. The indentation is just how
>>> browsers format lists.
>> 
>> 
>> Facepalm. Thanks.
>> //m
>>> 
>>> --
>>> David Goodger <http://python.net/~goodger>
>