autogen icon indicating copy to clipboard operation
autogen copied to clipboard

Add example of good doc sting to CONTRIBUTING.md

Open gagb opened this issue 1 year ago • 3 comments

What feature would you like to be added?

Template and example for doc string that works well with the Sphinx theme.

Why is this needed?

To invite higher quality contributions.

gagb avatar Dec 02 '24 18:12 gagb

Can we also have an etiquette whether system prompts and descriptions (usually long strings) should be set directly in the constructor. This can make the docs look busy as show below. Instead, we could use class variables. cc @afourney

Image

gagb avatar Dec 03 '24 06:12 gagb

I feel like in the cases I looked at the documentation engine expanded the constants.

I do not believe all of those long prompts are actually specified directly in the constructors?

afourney avatar Dec 03 '24 06:12 afourney

I feel like in the cases I looked at the documentation engine expanded the constants.

I do not believe all of those long prompts are actually specified directly in the constructors?

The engine expands if the constant is used as the default. If None is used, it won't expand it.

gagb avatar Dec 11 '24 22:12 gagb