[Python-Dev] ReST documents

2014-02-06 Thread Ethan Furman

My apologies if this is a stupid question (actually, two stupid questions! ;) , 
but:

  - is there someplace I can look to see what all the meta commands mean?  Things like :class: or .. index:: pair: 
class; constructor


  - when I click on a link (using FireFox 16.0.1) instead of showing the title of that section (such as IntEnum or 
object.__init__) it shows the paragraph immediately following.  I think it would be more helpful to show the title as 
well.  Is this an issue with how we are creating the docs, or with FireFox?


--
~Ethan~
___
Python-Dev mailing list
[email protected]
https://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
https://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


Re: [Python-Dev] ReST documents

2014-02-06 Thread Berker Peksağ
On Thu, Feb 6, 2014 at 9:53 PM, Ethan Furman  wrote:
> My apologies if this is a stupid question (actually, two stupid questions!
> ;) , but:
>
>   - is there someplace I can look to see what all the meta commands mean?
> Things like :class: or .. index:: pair: class; constructor

Hi,

I use the following links as reference:

- http://docs.python.org/devguide/documenting.html#id3
- http://sphinx-doc.org/domains.html#the-python-domain
- http://sphinx-doc.org/markup/inline.html#xref-syntax

--Berker
___
Python-Dev mailing list
[email protected]
https://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
https://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


Re: [Python-Dev] ReST documents

2014-02-06 Thread Ethan Furman

On 02/06/2014 01:51 PM, Berker Peksağ wrote:


I use the following links as reference:

- http://docs.python.org/devguide/documenting.html#id3
- http://sphinx-doc.org/domains.html#the-python-domain
- http://sphinx-doc.org/markup/inline.html#xref-syntax


Many thanks!

--
~Ethan~
___
Python-Dev mailing list
[email protected]
https://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
https://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


[Python-Dev] Google Summer of Code 2014: Looking for core python mentors!

2014-02-06 Thread Terri Oda
For anyone who completely isn't familiar with this: Google Summer of 
Code is a program where Google pays students to work on open source 
projects for the summer.  The motto goes: "Flip bits, not burgers."
 Google Summer of Code applications are open for mentoring 
organizations, and I've already put in Python's application.  You can 
get more info here:


https://wiki.python.org/moin/SummerOfCode/2014

What I'd like to know is if anyone's got any good ideas for core python 
projects this year and are interested in mentoring.  We always have lots 
of students who'd like to work on Python, but right now we don't have 
any mentors who are available and interested in helping students make 
contributions to the language (We do, however, have mentors for various 
python sub-projects).


Let me know if this might be interesting to you.  I'm happy to answer 
any questions, and I've got experienced mentors who aren't core python 
devs but who'd be willing to pair up so you wouldn't have to go it 
alone, just let me know!


 Terri

PS - I'm also looking for new sub-projects and other mentors -- just ask 
if you want to take part this year!


___
Python-Dev mailing list
[email protected]
https://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
https://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com