Skip to content

Latest commit

 

History

History

docs

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Promptflow documentation contribute guidelines

This folder contains the source code for prompt flow documentation site.

This readme file will not be included in above doc site. It keeps a guide for promptflow documentation contributors.

Content

Below is a table of important doc pages.

Category Article
Quick start Get started with prompt flow
Concepts Flows
Tools
Connections
Variants
How-to guides How to initialize and test a flow
How to run and evaluate a flow
How to tune prompts using variants
How to deploy a flow
How to create and use your own tool package
Tools reference LLM tool
Prompt tool
Python tool
SERP API tool
Embedding tool

Writing tips

  1. Reach the doc source repository by clicking Edit this page on any page. Edit this page
  2. Please use :::{admonition} for experimental feature or notes, and admonition with dropdown for the Limitation Part.
  3. Please use ::::{tab-set} to group your sdk/cli example, and put the cli at first. Use :sync: to sync multiple tables .
  4. If you are unclear with the above lines, refer to get started to see the usage.
  5. Add gif: Use ScreenToGif to record your screen, edit and save as a gif.
  6. Reach more element style at Sphinx Design Components.

Preview your changes

Local build: We suggest using local build at the beginning, as it's fast and efficiency.

cd .\scripts\docs

.\doc_generation.ps1 # Install requirements and build doc
# .\doc_generation.ps1 -SkipInstall # Skip install dependencies and build doc

start .\_build\index.html # See the homepage in your browser

FAQ

Adding image in doc

Please use markdown syntax ![img desc](img link) to reference image, because the relative path of image will be changed after sphinx build, and image placed in html tags can not be referenced when build.

Draw flow chart in doc

We recommend using the mermaid, learn more from the mermaid syntax doc

Reference