[Tutor] restructuredtext's documentation

2017-12-12 Thread adil gourinda
Hi
Please I have two questions:

1) Why restructuredtext's documentation is not included as a part of the 
official Python's documentation?

2) Can you generate a restructuredtext's PDF documentaion from Docutils 
website(docutils.sourceforge.net/rst.html)?

Thank you for your attention

___
Tutor maillist  -  Tutor@python.org
To unsubscribe or change subscription options:
https://mail.python.org/mailman/listinfo/tutor


Re: [Tutor] restructuredtext's documentation

2017-12-12 Thread Alan Gauld via Tutor
On 11/12/17 14:04, adil gourinda wrote:
> Hi
> Please I have two questions:
> 
> 1) Why restructuredtext's documentation is not included as a part of the 
> official Python's documentation?

Because the module is not part of the standard library.

Like most languages Python has a standard library that
ships with the interpreter. Anything beyond that has
to be downloaded/installed. Those extras are not part
of the standard library and therefore are not documented
on the official site.

Usually the third party module will have some kind
of web site with its own documentation.

> 2) Can you generate a restructuredtext's PDF 
> documentaion from Docutils website

The simplest way is just to load the documentation
page into a browser and print to a PDF file. There
seems to only be one file so that should be all
you need to do.

-- 
Alan G
Author of the Learn to Program web site
http://www.alan-g.me.uk/
http://www.amazon.com/author/alan_gauld
Follow my photo-blog on Flickr at:
http://www.flickr.com/photos/alangauldphotos


___
Tutor maillist  -  Tutor@python.org
To unsubscribe or change subscription options:
https://mail.python.org/mailman/listinfo/tutor


Re: [Tutor] restructuredtext's documentation

2017-12-12 Thread Steven D'Aprano
On Mon, Dec 11, 2017 at 02:04:59PM +, adil gourinda wrote:
> Hi
> Please I have two questions:
> 
> 1) Why restructuredtext's documentation is not included as a part of 
> the official Python's documentation?

Because RestructuredText (ReST) is not part of Python.

It is a project which uses Python.

 
> 2) Can you generate a restructuredtext's PDF documentaion from 
> Docutils website(docutils.sourceforge.net/rst.html)?

Sure. In your browser, go to the page you want, then choose Print from 
the browser File menu. When the printer dialog comes up, choose "Print 
To File", and set the options to PDF.


-- 
Steve
___
Tutor maillist  -  Tutor@python.org
To unsubscribe or change subscription options:
https://mail.python.org/mailman/listinfo/tutor


[Tutor] When do you know you're ready to start applying for jobs?

2017-12-12 Thread Matthew Ngaha
Hi all. I took 2-3 years off in 2012 to teach myself programming. I
learnt basic Javascript & Python with some Django. I don't have a
Computer Science (CS) degree so I never applied for a job because I
always thought I still had lots to learn and most jobs say a CS degree
is required. In 2015 I had to stop my learning to find a real minimum
wage job as I needed to support myself. I will never know now if I
would have got a python job had I applied. It's now december 2017, so
I haven't touched programming in 2 years. I've forgotten most of what
I learnt now. :( I'm now financially secure to give programming
another go but I don't know how I feel about relearning everything I
forgot. Is it's worth it? What are your thoughts?

Can I get a junior programming job without a CS degree?
When do you know you're ready to start applying for jobs? How can a
self learner ever know?
should I have applied for some jobs back in 2015 when I was still studying?
What are your opinions on my situation? Is learning Python all over
again worth it without a CS degree? would I be wasting my time?
___
Tutor maillist  -  Tutor@python.org
To unsubscribe or change subscription options:
https://mail.python.org/mailman/listinfo/tutor


Re: [Tutor] When do you know you're ready to start applying for jobs?

2017-12-12 Thread leam hall
On Tue, Dec 12, 2017 at 2:43 PM, Matthew Ngaha  wrote:

> Can I get a junior programming job without a CS degree?
> When do you know you're ready to start applying for jobs? How can a
> self learner ever know?
> should I have applied for some jobs back in 2015 when I was still studying?
> What are your opinions on my situation? Is learning Python all over
> again worth it without a CS degree? would I be wasting my time?
>


Most of the bugs in current commercial software packages were written by CS
grads. Keep that in mind.

The real question is, "do you enjoy coding so much you stay a newbie?"
There are always things to learn. Do the Tutor stuff. Do CodeWarrior. If
you enjoy it then look at job listsing and play with the stuff they are
asking for. Continue to take classes.  Work through a book of advanced
topics. Help with open source projects. Answer questions for newbies when
you can.

If that's the life you want to lead then jump in. It will be a second job
that doesn't pay for a while, but if you keep it up you'll find the right
spot.

Leam
___
Tutor maillist  -  Tutor@python.org
To unsubscribe or change subscription options:
https://mail.python.org/mailman/listinfo/tutor


Re: [Tutor] restructuredtext's documentation

2017-12-12 Thread Albert-Jan Roskam

Op 12 dec. 2017 10:52 schreef Steven D'Aprano :
>
> On Mon, Dec 11, 2017 at 02:04:59PM +, adil gourinda wrote:
> > Hi
> > Please I have two questions:
> >
> > 1) Why restructuredtext's documentation is not included as a part of
> > the official Python's documentation?
>
> Because RestructuredText (ReST) is not part of Python.
>
> It is a project which uses Python.
>
>
> > 2) Can you generate a restructuredtext's PDF documentaion from
> > Docutils website(docutils.sourceforge.net/rst.html)?
>
> Sure. In your browser, go to the page you want, then choose Print from
> the browser File menu. When the printer dialog comes up, choose "Print
> To File", and set the options to PDF.

You could also try using a tool called pandoc, though you will also need 
LaTex/texlive for it (quite big). Alternatively: 
https://pypi.python.org/pypi/rst2pdf
___
Tutor maillist  -  Tutor@python.org
To unsubscribe or change subscription options:
https://mail.python.org/mailman/listinfo/tutor


Re: [Tutor] When do you know you're ready to start applying for jobs?

2017-12-12 Thread Rex via Tutor
Hi Matthew,

I am 61 years old and started to learn Python last winter to both exercise my 
mind and get a better handle on what this world of technology has become.  I’ve 
got a degree in biochemistry which I’ve never used professionally and the only 
programming experience I ever had was in college with Fortran which did not 
agree with me.  On the other hand I have done some CNC programming the old 
fashioned way in the 1970’s by typing on a teletype to a paper punch tape the 
x, y, i, j, and m codes that controlled machine tools.

My experience with Python has opened my eyes to a whole new world and I think 
you under estimated yourself when you chose a minimum wage job over seeking 
employment in coding.  From everything I have learned and read about, you have 
a valuable asset with what you have already learned.  In my opinion, it will 
not be too difficult to get back on the horse and in fact you will probably be 
an even better programmer due to the reinforcement learning that will occur as 
you re-learn Python.

Remember, in this life, you must take risks to succeed and have confidence in 
yourself.  Genius is 1% inspiration and 99% perspiration.

Go for it.

Sent from my iPhone

> On Dec 12, 2017, at 2:43 PM, Matthew Ngaha  wrote:
> 
> Hi all. I took 2-3 years off in 2012 to teach myself programming. I
> learnt basic Javascript & Python with some Django. I don't have a
> Computer Science (CS) degree so I never applied for a job because I
> always thought I still had lots to learn and most jobs say a CS degree
> is required. In 2015 I had to stop my learning to find a real minimum
> wage job as I needed to support myself. I will never know now if I
> would have got a python job had I applied. It's now december 2017, so
> I haven't touched programming in 2 years. I've forgotten most of what
> I learnt now. :( I'm now financially secure to give programming
> another go but I don't know how I feel about relearning everything I
> forgot. Is it's worth it? What are your thoughts?
> 
> Can I get a junior programming job without a CS degree?
> When do you know you're ready to start applying for jobs? How can a
> self learner ever know?
> should I have applied for some jobs back in 2015 when I was still studying?
> What are your opinions on my situation? Is learning Python all over
> again worth it without a CS degree? would I be wasting my time?
> ___
> Tutor maillist  -  Tutor@python.org
> To unsubscribe or change subscription options:
> https://mail.python.org/mailman/listinfo/tutor

___
Tutor maillist  -  Tutor@python.org
To unsubscribe or change subscription options:
https://mail.python.org/mailman/listinfo/tutor


Re: [Tutor] When do you know you're ready to start applying for jobs?

2017-12-12 Thread Alan Gauld via Tutor
On 12/12/17 19:43, Matthew Ngaha wrote:
> Hi all. I took 2-3 years off in 2012 to teach myself programming. I
> learnt basic Javascript & Python with some Django. I don't have a
> Computer Science (CS) degree 

The key issue here is what is true in your locality.

In my part of the world the vast majority of programmers do
NOT have a CS (or software engineering degree - something
quite different). But they a majority do have a degree with a
numerical bias(science, engineering, maths etc)

On the other hand I've worked with programmers who studied
business law, zoology and even music. And quite a few with
no degree at all.

But I know of other places where a degree is essential and
in some places it has to be computing related.

So it all depends on your local practices and I can't comment
on that.

> ...so I never applied for a job because I
> always thought I still had lots to learn and most jobs say a CS degree

But you certainly do have a lot to learn, and in computing
you never stop having lots to learn. It is one of the
fastest moving industries around. Much (most?) of what you
learn today will have changed in 10 years time.

But there are things you can learn now that won't ever change.
And that includes the principles of design - an aspect all too
often ignored by people learning "programming" But you can't
build a significant system of any kind without an underlying
design. And you can't build big systems without understanding architecture.

And there are standard design patterns and architectural
patterns that you can learn (MVC, State machines,
Client-Server etc). There are principles (like coupling
and cohesion) and axioms like DRY. There are performance
patterns too, understanding O() notation and the factors
that affect it.

Then there are industry practices and tools. Do you know
about version and release control? Debugging tools? Profiling?

Hopefully you see where I'm going - you never stop learning
and you can waste a lot of time becoming an expert in things
that will be of no use in a few years, or you can focus on
principles that are the very basis of system design and
construction.

There is a big gulf between being a "programmer" and being
a professional software engineer. Your best bet may be to
get a job in a small one man shop building small web sites
for small businesses. That way you can learn about the
deeper issues as you go, in a kind of apprenticeship.

But don't get hung up on languages or frameworks - these
things come and go like fashions on a catwalk. If you
understand the principles you will learn new languages
in a matter of days and weeks. Frameworks in weeks or months.

> I haven't touched programming in 2 years. I've forgotten most of what
> I learnt now. 

Two years is not long. Try it in your spare time. If
it isn't coming back within a week then maybe its not
for you, or maybe just as a hobby. But if you have a
talent for it you should find it falls into place
quite quickly.

But programming for fun is a worthwhile thing too. I
never code for profit these days but I still write
code every week and usually have 2 or 3 projects
simmering away at any one time. They make my life
easier and I enjoy coding them - it's a win-win.

> Can I get a junior programming job without a CS degree?
> When do you know you're ready to start applying for jobs? How can a
> self learner ever know?

That all depends on local circumstances and the individual.
If in doubt try joining an open source project. If you can
get to the stage where the other developers treat you as an
equal then you are definitely ready for a job! (And it's good
to have on your CV/resume)

HTH
-- 
Alan G
Author of the Learn to Program web site
http://www.alan-g.me.uk/
http://www.amazon.com/author/alan_gauld
Follow my photo-blog on Flickr at:
http://www.flickr.com/photos/alangauldphotos


___
Tutor maillist  -  Tutor@python.org
To unsubscribe or change subscription options:
https://mail.python.org/mailman/listinfo/tutor