Commits

Rami Chowdhury  committed 77fade6

Better phrasing, more links in architecture & introduction documents

  • Participants
  • Parent commits 7df2382
  • Branches improve-docs

Comments (0)

Files changed (2)

File pypy/doc/architecture.rst

 
 .. contents::
 
-This document gives an overview of the goals and architecture of PyPy.
-See :doc:`getting started <getting-started>` for a practical introduction and starting points.
+This document gives an overview of the goals and architecture of PyPy. If you're
+interested in :ref:`using PyPy <using-pypy>` or :ref:`hacking on it <developing-pypy>`,
+have a look at our :ref:`getting started <getting-started-index>` section.
 
 
 Mission statement

File pypy/doc/introduction.rst

 =============
 
 In common parlance, PyPy has been used to mean two things.  The first is the
-:doc:`RPython translation toolchain <rpython:translation>`, which is a framework for generating
+:ref:`RPython translation toolchain <rpython:rpython>`, which is a framework for generating
 dynamic programming language implementations.  And the second is one
 particular implementation that is so generated --
 an implementation of the Python_ programming language written in
 This double usage has proven to be confusing, and we are trying to move
 away from using the word PyPy to mean both things.  From now on we will
 try to use PyPy to only mean the Python implementation, and say the
-:doc:`RPython translation toolchain <rpython:translation>` when we mean the framework.  Some older
-documents, presentations, papers and videos will still have the old
+:ref:`RPython translation toolchain <rpython:rpython>` when we mean the framework.
+
+Some older documents, presentations, papers and videos will still have the old
 usage.  You are hereby warned.
 
 We target a large variety of platforms, small and large, by providing a
 compiler toolsuite that can produce custom Python versions.  Platform, memory
 and threading models, as well as the JIT compiler itself, are aspects of the
 translation process - as opposed to encoding low level details into the
-language implementation itself. :doc:`more... <architecture>`
+language implementation itself.
+
+For more details, have a look at our :doc:`architecture overview <architecture>`.
+
+.. _Python: http://python.org
+.. _