microsoft
Documentation improvement suggestions
The documentation is a bit lacking in a few areas.
Most notable of these are the fact that there is too much information compiled into a single page, arguably too much repetition of the same information, missing details on how certain parameters work, and no images to visualize the effects of the parameters that affect how the prompt or output appears.
My proposed rework of the documentation is to split out the sections into their own pages:
- Basic Components
- Intentions
- Role
- Data Displays
- Utilities
Then add a new page, Formatting, to showcase what specific components and parameters can change in the prompt or output. This would be the page to provide images for some of the more esoteric parameters, such as position or speaker, whose effects are underexplained in the existing documentation.
That would make things a lot more manageable when trying to find specific information while crafting prompts.
That's good suggestions. I'll get back to refine the documents in the next iteration cycle.
