Fix spelling in documents (#6948)
* Update roxygen2 doc. Co-authored-by: fis <jm.yuan@outlook.com>
This commit is contained in:
@@ -23,7 +23,7 @@ C++ Coding Guideline
|
||||
***********************
|
||||
Python Coding Guideline
|
||||
***********************
|
||||
- Follow `PEP 8: Style Guide for Python Code <https://www.python.org/dev/peps/pep-0008/>`_. We use PyLint to automatically enforce PEP 8 style across our Python codebase. Before submitting your pull request, you are encouraged to run PyLint on your machine. See :ref:`running_checks_locally`.
|
||||
- Follow `PEP 8: Style Guide for Python Code <https://www.python.org/dev/peps/pep-0008/>`_. We use Pylint to automatically enforce PEP 8 style across our Python codebase. Before submitting your pull request, you are encouraged to run Pylint on your machine. See :ref:`running_checks_locally`.
|
||||
- Docstrings should be in `NumPy docstring format <https://numpydoc.readthedocs.io/en/latest/format.html>`_.
|
||||
|
||||
.. _running_checks_locally:
|
||||
|
||||
@@ -25,6 +25,6 @@ inside the ``doc/`` directory.
|
||||
Examples
|
||||
********
|
||||
* Use cases and examples will be in `demo <https://github.com/dmlc/xgboost/tree/master/demo>`_.
|
||||
* We are super excited to hear about your story, if you have blogposts,
|
||||
tutorials code solutions using XGBoost, please tell us and we will add
|
||||
* We are super excited to hear about your story. If you have blog posts,
|
||||
tutorials, or code solutions using XGBoost, please tell us, and we will add
|
||||
a link in the example pages.
|
||||
|
||||
@@ -15,7 +15,7 @@ A robust and efficient **continuous integration (CI)** infrastructure is one of
|
||||
|
||||
There are several CI services available free to open source projects, such as Travis CI and AppVeyor. The XGBoost project already utilizes Travis and AppVeyor. However, the XGBoost project has needs that these free services do not adequately address. In particular, the limited usage quota of resources such as CPU and memory leaves XGBoost developers unable to bring "too-intensive" tests. In addition, they do not offer test machines with GPUs for testing XGBoost-GPU code base which has been attracting more and more interest across many organizations. Consequently, the XGBoost project self-hosts a cloud server with Jenkins software installed: https://xgboost-ci.net/.
|
||||
|
||||
The self-hosted Jenkins CI server has recurring operating expenses. It utilizes a leading cloud provider (AWS) to accommodate variable workload. The master node serving the web interface is available 24/7, to accomodate contributions from people around the globe. In addition, the master node launches slave nodes on demand, to run the test suite on incoming contributions. To save cost, the slave nodes are terminated when they are no longer needed.
|
||||
The self-hosted Jenkins CI server has recurring operating expenses. It utilizes a leading cloud provider (AWS) to accommodate variable workload. The master node serving the web interface is available 24/7, to accommodate contributions from people around the globe. In addition, the master node launches slave nodes on demand, to run the test suite on incoming contributions. To save cost, the slave nodes are terminated when they are no longer needed.
|
||||
|
||||
To help defray the hosting cost, the XGBoost project seeks donations from third parties.
|
||||
|
||||
@@ -25,7 +25,7 @@ Donors may choose to make one-time donations or recurring donations on monthly o
|
||||
|
||||
Fiscal host: Open Source Collective 501(c)(6)
|
||||
---------------------------------------------
|
||||
The Project Management Committee (PMC) of the XGBoost project appointed `Open Source Collective <https://opencollective.com/opensource>`_ as their **fiscal host**. The platform is a 501(c)(6) registered entity and will manage the funds on the behalf of the PMC so that PMC members will not have to manage the funds directly. The platform currently hosts several well-known Javascript frameworks such as Babel, Vue, and Webpack.
|
||||
The Project Management Committee (PMC) of the XGBoost project appointed `Open Source Collective <https://opencollective.com/opensource>`_ as their **fiscal host**. The platform is a 501(c)(6) registered entity and will manage the funds on the behalf of the PMC so that PMC members will not have to manage the funds directly. The platform currently hosts several well-known JavaScript frameworks such as Babel, Vue, and Webpack.
|
||||
|
||||
All expenses incurred for hosting CI will be submitted to the fiscal host with receipts. Only the expenses in the following categories will be approved for reimbursement:
|
||||
|
||||
|
||||
@@ -8,7 +8,7 @@ Versioning Policy
|
||||
|
||||
Starting from XGBoost 1.0.0, each XGBoost release will be versioned as [MAJOR].[FEATURE].[MAINTENANCE]
|
||||
|
||||
* MAJOR: We gurantee the API compatibility across releases with the same major version number. We expect to have a 1+ years development period for a new MAJOR release version.
|
||||
* MAJOR: We guarantee the API compatibility across releases with the same major version number. We expect to have a 1+ years development period for a new MAJOR release version.
|
||||
* FEATURE: We ship new features, improvements and bug fixes through feature releases. The cycle length of a feature is decided by the size of feature roadmap. The roadmap is decided right after the previous release.
|
||||
* MAINTENANCE: Maintenance version only contains bug fixes. This type of release only occurs when we found significant correctness and/or performance bugs and barrier for users to upgrade to a new version of XGBoost smoothly.
|
||||
|
||||
@@ -21,10 +21,10 @@ Making a Release
|
||||
1. Modify ``CMakeLists.txt`` source tree, run CMake.
|
||||
2. Modify ``DESCRIPTION`` in R-package.
|
||||
3. Run ``change_version.sh`` in ``jvm-packages/dev``
|
||||
3. Commit the change, create a PR on github on release branch. Port the bumped version to default branch, optionally with the postfix ``SNAPSHOT``.
|
||||
4. Create a tag on release branch, either on github or locally.
|
||||
5. Make a release on github tag page, which might be done with previous step if the tag is created on github.
|
||||
6. Submit pip, cran and maven packages.
|
||||
- pip package is maintained by [Hyunsu Cho](http://hyunsu-cho.io/) and [Jiaming Yuan](https://github.com/trivialfis). There's a helper script for downloading pre-built wheels on ``xgboost/dev/release-pypi.py`` along with simple instructions for using ``twine``.
|
||||
- cran package is maintained by [Tong He](https://github.com/hetong007).
|
||||
- maven packageis maintained by [Nan Zhu](https://github.com/CodingCat).
|
||||
3. Commit the change, create a PR on GitHub on release branch. Port the bumped version to default branch, optionally with the postfix ``SNAPSHOT``.
|
||||
4. Create a tag on release branch, either on GitHub or locally.
|
||||
5. Make a release on GitHub tag page, which might be done with previous step if the tag is created on GitHub.
|
||||
6. Submit pip, CRAN, and Maven packages.
|
||||
- The pip package is maintained by [Hyunsu Cho](http://hyunsu-cho.io/) and [Jiaming Yuan](https://github.com/trivialfis). There's a helper script for downloading pre-built wheels on ``xgboost/dev/release-pypi.py`` along with simple instructions for using ``twine``.
|
||||
- The CRAN package is maintained by [Tong He](https://github.com/hetong007).
|
||||
- The Maven package is maintained by [Nan Zhu](https://github.com/CodingCat).
|
||||
|
||||
Reference in New Issue
Block a user