[API Doc] Syntax-related issues and other possible problems in Chronos API doc

[AndyLuo1029]

This issue summarized most problems in Chronos API modules (different sections in API doc page) , please go through it and revise your responsible module according to the problems it has.

Classification and explaination of problems

General Problems

For some general problems, the modules are classified and listed according to the problems they have.

TIPS:Most of the general suggestions are from #6421 , authored by @Oscilloscope98 . You can check this issue for more information about general suggestions in detail.

1. Wrong rst inline-code syntax.

For parameter's value options written in "value" or 'value' , it would be clearer to write them through rst inline code syntax as ``value`` to ensure that it will be displayed in correct inline code format in the doc.

Incorrect syntax examples:

If the module you are responsible for is tagged with this problem, please check if there is any inline-code problem in the class description/ method description/ variable description of the module.

2. Wrong rst param syntax.

Incorrect param rst syntax can cause errors in the generation and display of API documentation.

Incorrect display examples:

Correct display example:

If the module you are responsible for is tagged with this problem, please check if there is any param syntax problem in the variable description of the module.

3. Problems related to the return field of the method.

The return value format is not consistent in the method explanation of parts of the API documentation. Problems include:

• Some methods don't give the return value
• Some methods describe the return value in methods description instead of writing it through the return field
• Some methods don't write the return value in correct syntax, resulting in display problems

Such inconsistency is not user-friendly. It is suggested that all methods can be unified to add the return value field in correct syntax, and explain the return value clearly (None for methods with no return value ).

If the module you are responsible for is tagged with this problem, please check return fields of all the methods it contains.

4. Raw hyperlinks.

When link to reference page, please add hyperlink in correct syntax to get appropriate display.

Incorrect hyperlink add example：

If the module you are responsible for is tagged with this problem, please check all hyperlinks in it.

5. Incorrectly-displayed quote block.

Some API explanations are incorrectly displayed in quote blocks. This problem is always related to incorrect syntax for lists. Such erroneous displays should be corrected.

Incorrectly-displayed quote block example:

If the module you are responsible for is tagged with this problem, please check where the quote block is miss-used.

Special Problems

A few modules have specific issues and are listed after the general problems classification. Please check if there are special problems with the module you are responsible for.

Classification of general problems

This section classified Chronos API modules (different sections in API doc page) based on the type of problems they contain, please go through all the types of problems to checkout whether your responsible module has some of the problems.

1. Wrong rst inline-code syntax

AutoTS

• AutoTSEstimator
• TSPipeline

Auto Models

• AutoTCN
• AutoLSTM
• AutoSeq2Seq
• AutoARIMA
• AutoProphet

Forecasters

• LSTMForecaster in PyTorch Tag
• LSTMForecaster in Tensorflow tag
• Seq2SeqForecaster in PyTorch Tag
• Seq2SeqForecaster in Tensorflow Tag
• TCNForecaster in PyTorch Tag
• TCNForecaster in Tensorflow Tag
• AutoformerForecaster
• NBeatsForecaster
• TCMFForecaster
• MTNetForecaster
• ARIMAForecaster
• ProphetForecaster

Anomaly Detectors

• AEDetector
• DBScanDetector
• ThresholdDetector

TSDataset

• TSDataset
• XShardsTSDataset
• Built-in Dataset

Simulator

• DPGANSimulator

Evaluator

• Evaluator

AutoTS (deprecated)

• Recipe

2. Wrong rst param syntax

Forecasters

• LSTMForecaster in Tensorflow tag
• Seq2SeqForecaster in PyTorch Tag
• Seq2SeqForecaster in Tensorflow Tag
• TCNForecaster in PyTorch Tag
• TCNForecaster in Tensorflow Tag
• AutoformerForecaster
• NBeatsForecaster

TSDataset

• TSDataset

AutoTS (deprecated)

• AutoTSTrainer

3. Problems related to the return field of the method

AutoTS

• TSPipeline

Auto Models

• AutoTCN
• AutoLSTM
• AutoSeq2Seq
• AutoARIMA
• AutoProphet

Forecasters

• LSTMForecaster in PyTorch tag
• LSTMForecaster in Tensorflow tag
• Seq2SeqForecaster in PyTorch Tag
• Seq2SeqForecaster in Tensorflow Tag
• TCNForecaster in PyTorch Tag
• TCNForecaster in Tensorflow Tag
• AutoformerForecaster
• NBeatsForecaster
• TCMFForecaster
• MTNetForecaster
• ARIMAForecaster
• ProphetForecaster

Anomaly Detectors

• AEDetector
• DBScanDetector
• ThresholdDetector

TSDataset

• Built-in Dataset

Simulator

• DPGANSimulator

Evaluator

• Evaluator

AutoTS (deprecated)

• AutoTSTrainer
• TSPipeline
• Recipe

4. Raw hyperlinks

Auto Models

• AutoARIMA
• AutoProphet

Forecasters

• LSTMForecaster in PyTorch tag
• Seq2SeqForecaster in PyTorch Tag
• TCNForecaster in PyTorch Tag
• AutoformerForecaster
• NBeatsForecaster
• ARIMAForecaster
• ProphetForecaster

TSDataset

• TSDataset
• Built-in Dataset

AutoTS (deprecated)

• Recipe

5. Incorrectly-displayed quote blocks

Forecasters

• LSTMForecaster in Pytorch tag
• Seq2SeqForecaster in PyTorch Tag
• TCNForecaster in PyTorch Tag
• NBeatsForecaster

Special problems

This section listed all the modules that have some special problems, please go through it to checkout whether your responsible module are here.

AutoTS -> TSPipeline:

• class bigdl.chronos.autots.tspipeline.TSPipeline :
  • No description for this class in detail (e.g. params of the class).

Auto Models -> AutoARIMA:

• class bigdl.chronos.autots.model.auto_arima.AutoARIMA :
  • Missing explaination of parameter load_dir in parameter description.

Forecasters -> LSTMForecaster in Pytorch tag:

• method bigdl.chronos.forecaster.lstm_forecaster.LSTMForecaster.tune :
  • The parameters directions=None and **kwargs in method declaration disappeared in parameter descriptions.

Forecasters -> LSTMForecaster in Tensorflow tag:

• method bigdl.chronos.forecaster.tf.lstm_forecaster.LSTMForecaster.to_local :
  • Method description is displayed incorrectly after line break.

Forecasters -> Seq2SeqForecaster in PyTorch Tag:

• method to_local :

  • Method description is displayed incorrectly.

• method tune :

  • The parameters directions=None and **kwargs in method declaration disappeared in parameter descriptions.

Forecasters -> Seq2SeqForecaster in Tensorflow Tag:

• method to_local :
  • Method description is displayed incorrectly.

Forecasters -> TCNForecaster in PyTorch Tag:

• method to_local :

  • Method description is displayed incorrectly.

• method tune :

  • The parameters directions=None and **kwargs in method declaration disappeared in parameter descriptions.

Forecasters -> TCNForecaster in Tensorflow Tag:

• method to_local :
  • Method description is displayed incorrectly.

Forecasters -> NBeatsForecaster:

• method to_local :

  • Method description is displayed incorrectly.

• method tune :

  • The parameters directions=None and **kwargs in method declaration disappeared in parameter descriptions.

AutoTS (deprecated) -> Recipe:

• • Many classes doesn't have correct base explanation.
    Examples:
    
• • Many classes' description displays incorrectly.
    Examples: