This translation of the original content is out of date!
See what changed in the original content
diff --git a/content/contributing/how/process/contents.lr b/content/contributing/how/process/contents.lr
index eb1fd4280..763a59c11 100644
--- a/content/contributing/how/process/contents.lr
+++ b/content/contributing/how/process/contents.lr
@@ -8,26 +8,134 @@ summary: The BeeWare development process
---
body:
-This is where the BeeWare contribution guide will eventually go. We don't have a concrete set of policies and procedures yet - but we know they're really important, and we're intending to write them as soon as we get a chance.
+Code style
+---------------
+
+Please follow these coding standards when writing code for inclusion in BeeWare projects. Unless otherwise specified,
+follow :pep:`8` (with careful attention paid to
+`Section 2 <https://www.python.org/dev/peps/pep-0008/#a-foolish-consistency-is-the-hobgoblin-of-little-minds>`__) Use
+`flake8 <https://pypi.python .org/pypi/flake8>`__ to check for problems in this area. Remember that :pep:`8` is only a
+guide, so respect the style of the surrounding code as a primary goal.
+
+An exception to :pep:`8` is our rules on line lengths. Don't limit lines of code to 79 characters if it means the code
+looks significantly uglier or is harder to read. We allow up to 119 characters as this is the width of GitHub code
+review; anything longer requires horizontal scrolling which makes review more difficult. This check is included when you
+run ``flake8``. Documentation, comments, and docstrings should be wrapped at 79 characters, even though :pep:`8`
+suggests 72.
+
+* Use four spaces for indentation.
+
+* Use four space hanging indentation rather than vertical alignment::
+
+ raise AttributeError(
+ 'Here is a multine error message '
+ 'shortened for clarity.'
+ )
+
+ Instead of::
+
+ raise AttributeError('Here is a multine error message '
+ 'shortened for clarity.')
+
+ This makes better use of space and avoids having to realign strings if the length of the first line changes.
+
+* Use single quotes for strings, or a double quote if the the string contains a single quote. Don't waste time doing
+ unrelated refactoring of existing code to conform to this style.
+
+* Avoid use of "we" in comments, e.g. "Loop over" rather than "We loop over".
+
+* Use underscores, not camelCase, for variable, function and method names
+
+* Use InitialCaps for class names (or for factory functions that return classes).
+
+* Use the Google Style Python Docstrings and :pep:`257`, type annotation with :pep:`484` is optional.
+
+ ::
+
+ def function_with_types_in_docstring(param1, param2):
+ """Example function with types documented in the docstring.
+
+ Args:
+ param1 (int): The first parameter.
+ param2 (str): The second parameter.
+
+ Returns:
+ bool: The return value. True for success, False otherwise.
+
+ """
-In the meantime: Follow `PEP8 <https://www.python.org/dev/peps/pep-0008/>`__ (with careful attention paid to `Section 2 <https://www.python.org/dev/peps/pep-0008/#a-foolish-consistency-is-the-hobgoblin-of-little-minds>`__), and Github vanilla forking procedures. We'll work the rest out as we go.
+ `More examples of Google Docstrings <https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_google.html>`__
+* In test docstrings, state the expected behavior that each test demonstrates. Don't include preambles such as "Tests
+ that" or "Ensures that".
+* Reserve ticket references for obscure issues where the ticket has additional details that can't be easily described in
+ docstrings or comments. Include the ticket number at the end of a sentence like this::
+
+ def test_foo():
+ """A test docstring looks like this (#123456).
+ """
+
+Imports
+---------------
+
+Use `isort <https://github.com/timothycrosley/isort#readme>`_ to automate
+import sorting using the guidelines below.
+
+Quick start::
+
+ $ pip install isort
+ $ isort -rc .
+
+This runs ``isort`` recursively from your current directory, modifying any
+files that don't conform to the guidelines. If you need to have imports out
+of order (to avoid a circular import, for example) use a comment like this::
+
+ import module # isort:skip
+
+Put imports in these groups: standard library, third-party libraries, other BeeWare components, local BeeWare component,
+try/excepts. Sort lines in each group alphabetically by the full module name. Place all ``import module`` statements
+before ``from module import objects`` in each section. Use absolute imports for other BeeWare components and relative
+imports for local components.
+
+On each line, alphabetize the items with the upper case items grouped before the lower case items.
+
+Break long lines using parentheses and indent continuation lines by 4 spaces. Include a trailing comma after the last
+import and put the closing parenthesis on its own line.
+
+Use a single blank line between the last import and any module level code, and use two blank lines above the first
+function or class.
+
+
+Miscellaneous
+---------------
+
+Remove ``import`` statements that are no longer used when you change code. `flake8 <https://pypi.python
+.org/pypi/flake8>`__ will identify these imports for you. If an unused import needs to remain for
+backwards-compatibility, mark the end of with ``# NOQA`` to silence the flake8 warning.
+
+Systematically remove all trailing whitespaces from your code as those add unnecessary bytes, add visual clutter to the
+patches and can also occasionally cause unnecessary merge conflicts. Some IDE's can be configured to automatically
+remove them and most VCS tools can be set to highlight them in diff outputs.
Sign your work
---------------
-Before we can merge your contribution into BeeWare, you need to give us permission to do so. Since you're an author of a creative work (a piece of code, or some documentation), you automatically own the copyright for that work. BeeWare can't legally use that contribution unless you give us permission to do so.
+Before we can merge your contribution into BeeWare, you need to give us permission to do so. Since you're an author of a
+creative work (a piece of code, or some documentation), you automatically own the copyright for that work. BeeWare
+can't legally use that contribution unless you give us permission to do so.
-The BeeWare project uses a mechansim known as a `Developer Certificate of Origin (DCO) <./dco/>`__ to manage this process. The DCO is a legally binding statement that asserts that you are the creator of your contribution, and that you wish to allow BeeWare to use your work.
+The BeeWare project uses a mechanism known as a `Developer Certificate of Origin (DCO) </contributing/how/dco/>`__ to
+manage this process. The DCO is a legally binding statement that asserts that you are the creator of your contribution,
+and that you wish to allow BeeWare to use your work.
To indicate that you agree to the terms of the DCO, you just add a line to every git commit message::
Signed-off-by: Joe Smith <joe.smith@email.com>
-If you set your ``user.name`` and ``user.email`` as part of your git configuration, you can sign your commit automatically with ``git commit -s``.
+If you set your ``user.name`` and ``user.email`` as part of your git configuration, you can sign your commit
+automatically with ``git commit -s``.
-If you have more questions about Developer Certificates of Origin, why are required, what they mean, and how to configure your system to use them, see `The Beginners Guide to DCOs <./dco/>`__, or `get in touch with the core team </community/team>`__.
-
----
-incomplete: yes
+If you have more questions about Developer Certificates of Origin, why they are required, what they mean, and how to
+configure your system to use them, see `The Beginners Guide to DCOs </contributing/how/dco/>`__, or `get in touch with
+the core team </community/team>`__.
This page's contents is incomplete. You can help by貢獻翻譯。
這裡是貢獻指南將去的地方。我們還是沒有具體的規範和程序——可是我們承認都很重要,而且打算一有機會就要寫好。
在此期間: 參考 PEP8 (而且仔細關注 Section 2), and Github vanilla forking procedures. 其他的一出現我們就處理。
簽上您的工作
我們把你的貢獻合並起來之前,你必須給我們許可這樣做。因為你是作品的製造者(源碼或者文檔的作者),時你有知識產權的。BeeWare必須得到你的許可才能合法地使用你的貢獻。
BeeWare項目是以 Developer Certificate of Origin (DCO) 來管理這個過程. DCO是一種有法律约束力的宣告,是保證你是貢獻的製造者,而且你想讓BeeWare使用貢獻。
為了表示你同意DCO的條款,把下面的一行加入你的git commit message:
Signed-off-by: Joe Smith <joe.smith@email.com>
如果在git配置你指定 user.name 和 user.email, 你能以 git commit -s 來自動地簽commit message.
如果你還有關於Developer Certificates of Origin的問題,為什麼需要它,它是什麼意思,以及怎麼配置系統使用它,看看 The Beginners Guide to DCOs, 或者 聯繫核心團隊.