Changes to this project should be proposed as pull requests on GitHub at: https://github.com/lxc/linuxcontainers.org
Proposed changes will then go through code review there and once acked, be merged in the main branch.
The linuxcontainers.org website is licensed under the following license:
Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
Any contribution to the content must be made under the terms of this license.
Unless otherwise mentioned in the header, all other files are also licensed under the terms of the CC BY-NC-SA 4.0 license.
The author of a change remains the copyright holder of their code (no copyright assignment).
To improve tracking of contributions to this project we use the DCO 1.1 and use a "sign-off" procedure for all changes going into the branch.
The sign-off is a simple line at the end of the explanation for the commit which certifies that you wrote it or otherwise have the right to pass it on as an open-source contribution.
Developer Certificate of Origin Version 1.1
Copyright (C) 2004, 2006 The Linux Foundation and its contributors. 660 York Street, Suite 102, San Francisco, CA 94110 USA
Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
Developer's Certificate of Origin 1.1
By making a contribution to this project, I certify that:
(a) The contribution was created in whole or in part by me and I have the right to submit it under the open source license indicated in the file; or
(b) The contribution is based upon previous work that, to the best of my knowledge, is covered under an appropriate open source license and I have the right under that license to submit that work with modifications, whether created in whole or in part by me, under the same open source license (unless I am permitted to submit under a different license), as indicated in the file; or
(c) The contribution was provided directly to me by some other person who certified (a), (b) or (c) and I have not modified it.
(d) I understand and agree that this project and the contribution are public and that a record of the contribution (including all personal information I submit with it, including my sign-off) is maintained indefinitely and may be redistributed consistent with this project or the open source license(s) involved.
An example of a valid sign-off line is:
Signed-off-by: Random J Developer <[email protected]>
Use your real name and a valid e-mail address. Sorry, no pseudonyms or anonymous contributions are allowed.
Note:
- Sign-off each commit individually, even when it is part of a larger set.
- If multiple authors are participating, sign-off each commit individually by their author.
You can for example use git commit -s to sign-off each commit.
- Prefer smaller commits over large commits: For example one for each section
- Add useful messages to your commits, that describe the content or changes
The standard language for this project is American English (AE).
Translations for other languages are possible and appreciated. See Translations below for details.
-
Markdown: Standard Markdown language and the following extensions:
codehilite toc extra tables footnotes admonition wikilinks attr_list fenced_code pymdown-extensions
See also:
- source file of generate for currently enabled extensions.
- python-markdown documentation for details.
-
HTML: Used only when necessary.
-
You can add
Notes
orWarnings
:!!! note Content
!!! warning Content
-
To override the default title, add your custom title:
!!! note "注意" Content
- For long pages, add a table of contents by putting a [TOC] tag at the top of the page.
- Write short and continuous text.
- Use lists, tables and code tags.
- Use headers for each section and sub-section.
Copy the original file you want to translate (if a file for the translation is not already existing) and rename it.
File name:
Add the shortcut of the language to the filename.
For example, for the advanced-guide.md
:
advanced-guide.ja.md # japanese version
Layout:
Keep the original layout.
Accuracy:
Translate as accurate as possible.
Quality:
You should have good language skills.
Completeness:
Your pull request does not have to be complete, every piece of translation is a good start.
Keep the original content:
Add the original text as comments inside the text, with:
<!-- original text -->
Before opening a pull request, you should test the changes you made.
Generate and run a local copy of the website (see Readme.md) and check whether it works and looks correct in your browser.