[document][swagger]Update topics rest api document

[tuteng]

Motivation

The current rest api document parameters are missing descriptions and some parameters are missing.

Modifications

Improve document of topics

Does this pull request potentially affect one of the following parts:

If yes was chosen, please highlight the changes

• Dependencies (does it add or upgrade a dependency): (yes / no)
• The public API: (yes / no)
• The schema: (yes / no / don't know)
• The default values of configurations: (yes / no)
• The wire protocol: (yes / no)
• The rest endpoints: (yes / no)
• The admin cli options: (yes / no)
• Anything that affects deployment: (yes / no / don't know)

Documentation

• Does this pull request introduce a new feature? (yes / no)
• If yes, how is the feature documented? (not applicable / docs / JavaDocs / not documented)
• If a feature is not applicable for documentation, explain why?
• If a feature is not documented yet in this PR, please create a followup issue for adding the documentation

[jiazhai]

rerun java8 tests
for

org.apache.pulsar.functions.worker.PulsarFunctionStateTest.setup

[tuteng]

@jennifer88huang @Anonymitaet Can you take the time to help review the descriptive information of these modifications? Thank you very much

[Jennifer88huang-zz]

Good job, I just refine some typos. If you refine one of them, remember to check other same cases in this file.

[sijie]

@tuteng Can you please check each method and make sure all the response codes are documented?

e.g. 500 should be documented almost for each method (but you need to double check the code).

I made a few comments on the first few methods. Please use them as examples to update other methods.

[tuteng]

@tuteng Can you please check each method and make sure all the response codes are documented?

e.g. 500 should be documented almost for each method (but you need to double check the code).

I made a few comments on the first few methods. Please use them as examples to update other methods.

I'll check it later.

[tuteng]

@jennifer88huang @Anonymitaet @sijie PTAL

[Jennifer88huang-zz]

When you update one place, make sure you update other similar cases in the file.

[sijie]

@tuteng can you address the latest review comments?

[tuteng]

Done

[tuteng]

rerun java8 tests

[tuteng]

rerun java8 tests