mirror of
https://github.com/kennethreitz/python-guide.git
synced 2026-06-05 23:00:18 +00:00
Merge pull request #286 from artloder/minor-changes
Minor formatting changes.
This commit is contained in:
+1
-1
@@ -46,7 +46,7 @@ master_doc = 'index'
|
||||
|
||||
# General information about the project.
|
||||
project = u'pythonguide'
|
||||
copyright = u'2013. A <a href="http://kennethreitz.com/pages/open-projects.html">Kenneth Reitz</a> Project. <a href="http://creativecommons.org/licenses/by-nc-sa/3.0/"> Creative Commons Share-Alike 3.0</a>.'
|
||||
copyright = u'2013. A <a href="http://kennethreitz.com/pages/open-projects.html">Kenneth Reitz</a> Project. <a href="http://creativecommons.org/licenses/by-nc-sa/3.0/"> Creative Commons Share-Alike 3.0</a>'
|
||||
|
||||
# The version info for the project you're documenting, acts as replacement for
|
||||
# |version| and |release|, also used in various other places throughout the
|
||||
|
||||
@@ -14,22 +14,22 @@ from.
|
||||
In general, these licenses tend to fall into one of two categories:
|
||||
|
||||
1. licenses that focus more on the user's freedom to do with the
|
||||
software as they please (these are the more-permissive open
|
||||
software as they please (these are the more permissive open
|
||||
source licenses such as the MIT, BSD, & Apache).
|
||||
|
||||
2. licenses that focus more on making sure that the code itself —
|
||||
including any changes made to it and distributed along with it —
|
||||
always remains free (these are the less-permissive free software
|
||||
licenses, for example, the GPL and LGPL).
|
||||
always remains free (these are the less permissive free software
|
||||
licenses such as the GPL and LGPL).
|
||||
|
||||
The latter are less-permissive in the sense that they don't permit
|
||||
The latter are less permissive in the sense that they don't permit
|
||||
someone to add code to the software and distribute it without also
|
||||
including the source code for their changes.
|
||||
|
||||
To help you choose one for your project, there's a `license chooser <http://three.org/openart/license_chooser/>`_,
|
||||
**use it**.
|
||||
|
||||
**More-Permissive**
|
||||
**More Permissive**
|
||||
|
||||
- PSFL (Python Software Foundation License) -- for contributing to python itself
|
||||
- MIT / BSD / ISC
|
||||
@@ -40,7 +40,7 @@ To help you choose one for your project, there's a `license chooser <http://thre
|
||||
|
||||
- Apache
|
||||
|
||||
**Less-Permissive:**
|
||||
**Less Permissive:**
|
||||
|
||||
- LGPL
|
||||
- GPL
|
||||
|
||||
@@ -256,7 +256,7 @@ are a probable indication that such a refactoring is needed.
|
||||
Idioms
|
||||
------
|
||||
|
||||
A programming Idiom, put simply, is a *way* to write code. The notion of programming Idioms
|
||||
A programming idiom, put simply, is a *way* to write code. The notion of programming idioms
|
||||
is discussed amply at `c2 <http://c2.com/cgi/wiki?ProgrammingIdiom>`_ and at `Stack Overflow <http://stackoverflow.com/questions/302459/what-is-a-programming-idiom>`_.
|
||||
|
||||
Idiomatic Python code is often referred to as being *Pythonic*.
|
||||
|
||||
@@ -146,7 +146,7 @@ py.test is a no-boilerplate alternative to Python's standard unittest module.
|
||||
|
||||
$ pip install pytest
|
||||
|
||||
Despite being a fully-featured and extensible test tool it boasts a simple
|
||||
Despite being a fully-featured and extensible test tool, it boasts a simple
|
||||
syntax. Creating a test suite is as easy as writing a module with a couple of
|
||||
functions
|
||||
|
||||
|
||||
Reference in New Issue
Block a user