Skip to content

Commit

Permalink
Merge pull request #1373 from Sherry-XLL/1.1.x
Browse files Browse the repository at this point in the history
Fix warnings in docs and modify configuration
  • Loading branch information
Sherry-XLL authored Aug 2, 2022
2 parents 8c1a151 + 33ec0ec commit 411a45a
Show file tree
Hide file tree
Showing 8 changed files with 21 additions and 38 deletions.
4 changes: 2 additions & 2 deletions docs/source/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -20,11 +20,11 @@
# -- Project information -----------------------------------------------------

project = "RecBole"
copyright = "2020, RecBole Contributors"
copyright = "2022, RecBole Contributors"
author = "AIBox RecBole group"

# The full version, including alpha/beta/rc tags
release = "0.2.0"
release = "1.0.1"


# -- General configuration ---------------------------------------------------
Expand Down
6 changes: 3 additions & 3 deletions docs/source/developer_guide/customize_trainers.rst
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ and revise :meth:`~recbole.trainer.trainer.Trainer.evaluate` or :meth:`~recbole.
Example
----------------
1. Alternative Optimization
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
Here we present a simple Trainer example, which is used for alternative optimization.
We revise the :meth:`~recbole.trainer.trainer.Trainer._train_epoch` method.
To begin with, we need to create a new class for
Expand Down Expand Up @@ -105,7 +105,7 @@ Complete Code
return total_loss
2. Mixed precision training
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
Here we present a simple Trainer example, which is used for mixed
precision training. Mixed precision training offers significant
computational speedup by performing operations in half-precision
Expand Down Expand Up @@ -164,7 +164,7 @@ Complete Code
scaler.update()
3. Layer-specific learning rate
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
Here we present a simple Trainer example, which is used for setting
layer-specific learning rate. For pretrained model, layers closer to
the input layer are more likely to have learned more general
Expand Down
2 changes: 1 addition & 1 deletion docs/source/get_started/distributed_training.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
Distributed Training
===============
=======================
Now we support distributed training and evaluation. Here is a distributed training example for using RecBole.
We will show you how to train and test **BPR** model on the **ml-100k** dataset in the distributed environment.

Expand Down
16 changes: 4 additions & 12 deletions docs/source/get_started/started/context-aware.rst
Original file line number Diff line number Diff line change
@@ -1,16 +1,12 @@
Quick Start: Context-aware Recommendation
===============
============================================
For context-aware recommendation, we choose **LR** model to show you how to
train and test it on the **ml-100k** dataset from both **API** and
**source code**.

.. _header-n3:

Quick-start From API
---------------------

.. _header-n4:

1. Prepare your data:
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

Expand Down Expand Up @@ -43,8 +39,6 @@ we set ``rating=4`` as threshold to label the interaction. For more
information about label setting, please read the `Label of
data <https://recbole.io/docs/user_guide/data/label_of_data.html>`__.

.. _header-n9:

2. Choose a model:
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

Expand All @@ -66,10 +60,8 @@ If you want to run different models, you can read `Running Different
Models <https://recbole.io/docs/user_guide/usage/running_different_models.html>`__
for more information.

.. _header-n14:

3. Set training and evaluation config:
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

In RecBole, we support multiple training and evaluation methods. You can
choose how to train and test model by simply setting the config.
Expand Down Expand Up @@ -108,7 +100,7 @@ Settings <https://recbole.io/docs/user_guide/config/evaluation_settings.html>`__
.. _header-n19:

4. Run the model and collect the result
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

Now you have finished all the preparations, it’s time to run the model!

Expand Down Expand Up @@ -199,7 +191,7 @@ can read other docs for depth usage.
.. _header-n29:

Quick-start From Source
---------------------
-------------------------

Besides using API, you can also directly run the source code of
`RecBole <https://github.com/RUCAIBox/RecBole>`__. The whole process is
Expand Down
14 changes: 3 additions & 11 deletions docs/source/get_started/started/general.rst
Original file line number Diff line number Diff line change
@@ -1,16 +1,12 @@
Quick Start: General Recommendation
===============
=====================================
For general recommendation, we choose **BPR** model to show you how to train
and test it on the **ml-100k** dataset from both **API** and **source
code**.

.. _header-n3:

Quick-start From API
--------------------------

.. _header-n4:

1. Prepare your data:
>>>>>>>>>>>>>>>>>>>>>>>>>

Expand All @@ -36,8 +32,6 @@ General recommendation models utilize the historical interactions
between users and items to make recommendations, so it needs to specify
and load the user and item columns of the dataset.

.. _header-n9:

2. Choose a model:
>>>>>>>>>>>>>>>>>>>>>>>>>

Expand All @@ -59,10 +53,8 @@ If you want to run different models, you can read `Running Different
Models <https://recbole.io/docs/user_guide/usage/running_different_models.html>`__
for more information.

.. _header-n14:

3. Set training and evaluation config:
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

In RecBole, we support multiple training and evaluation methods. You can
choose how to train and test model by simply setting the config.
Expand Down Expand Up @@ -101,7 +93,7 @@ Settings <https://recbole.io/docs/user_guide/config/evaluation_settings.html>`__
.. _header-n40:

4. Run the model and collect the result
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

Now you have finished all the preparations, it’s time to run the model!

Expand Down
6 changes: 3 additions & 3 deletions docs/source/get_started/started/knowledge-based.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
Quick Start: Knowledge-based Recommendation
===============
=============================================
For Knowledge-based Recommendation, we choose **CKE** model to show you how
to train and test it on the **ml-100k** dataset from both **API** and
**source code**.
Expand Down Expand Up @@ -90,7 +90,7 @@ for more information.
.. _header-n164:

3. Set training and evaluation config:
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

In RecBole, we support multiple training and evaluation methods. You can
choose how to train and test model by simply setting the config.
Expand Down Expand Up @@ -123,7 +123,7 @@ Settings <https://recbole.io/docs/user_guide/config/evaluation_settings.html>`__
.. _header-n269:

4. Run the model and collect the result
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

Now you have finished all the preparations, it’s time to run the model!

Expand Down
8 changes: 3 additions & 5 deletions docs/source/get_started/started/sequential.rst
Original file line number Diff line number Diff line change
@@ -1,11 +1,9 @@
Quick Start: Sequential Recommendation
===============
========================================
For sequential recommendation, we choose **GRU4Rec** model to show you how
to train and test it on the **ml-100k** dataset from both **API** and
**source code**.

.. _header-n4:

Quick-start From API
---------------------

Expand Down Expand Up @@ -97,7 +95,7 @@ for more information.
.. _header-n16:

3. Set training and evaluation config:
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

In RecBole, we support multiple training and evaluation methods. You can
choose how to train and test model by simply setting the config.
Expand Down Expand Up @@ -134,7 +132,7 @@ Settings <https://recbole.io/docs/user_guide/config/evaluation_settings.html>`__
.. _header-n21:

4. Run the model and collect the result
>>>>>>>>>>>>>>>>>>>>>>>>>
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

Now you have finished all the preparations, it’s time to run the model!

Expand Down
3 changes: 2 additions & 1 deletion docs/source/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -89,6 +89,7 @@ Features:
recbole/recbole.utils.logger
recbole/recbole.utils.utils


The Team
------------------
RecBole is developed and maintained by `RUC, BUPT, ECNU <https://www.recbole.io/about.html>`_.
Expand All @@ -99,7 +100,7 @@ Here is the list of our lead developers in each development phase. They are the
Time Version Lead Developers
====================== =============== =============================================
June 2020 ~ Nov. 2020 v0.1.1 `Shanlei Mu <https://github.com/ShanleiMu>`_, `Yupeng Hou <https://github.com/hyp1231>`_, `Zihan Lin <https://github.com/linzihan-backforward>`_, `Kaiyuan Li <https://github.com/tsotfsk>`_
Nov. 2020 ~ Now v0.1.2 ~ v1.0.0 `Yushuo Chen <https://github.com/chenyushuo>`_, `Xingyu Pan <https://github.com/2017pxy>`_
Nov. 2020 ~ Now v0.1.2 ~ v1.0.1 `Yushuo Chen <https://github.com/chenyushuo>`_, `Xingyu Pan <https://github.com/2017pxy>`_
====================== =============== =============================================

License
Expand Down

0 comments on commit 411a45a

Please sign in to comment.