corrected python documentation (microsoft#501)

lightningRalf · dluc · web-flow · commit db2c1ef1289d · 2023-04-18T11:13:20.000-07:00
### Motivation and Context
1. Why is this change required? prompts are not semantic functions with
input &lt;-&gt; other way round
  2. What problem does it solve? clearer understanding
  3. What scenario does it contribute to? documentation

### Description
- corrected wording
- added a table for Q&amp;A


### Contribution Checklist
- [x] I didn't break anyone &#128516;

---------

Co-authored-by: Devis Lucato &lt;dluc@users.noreply.github.com&gt;
Co-authored-by: Devis Lucato &lt;devis@microsoft.com&gt;
diff --git a/python/README.md b/python/README.md
@@ -56,7 +56,7 @@ Give me the TLDR in exactly 5 words.""")
 print(prompt()) # => Robots must not harm humans.
 ```
 
-# Prompts are **semantic functions** with input parameters
+# **Semantic functions** are Prompts with input parameters
 
 ```python
 # Create a reusable function with one input parameter
@@ -99,14 +99,14 @@ Python notebooks:
 * [Using Context Variables to Build a Chat Experience](../samples/notebooks/python/04-context-variables-chat.ipynb)
 * [Building Memory with Embeddings](../samples/notebooks/python/06-memory-and-embeddings.ipynb)
 
-# Frequently asked questions
+# SK Frequently Asked Questions
 
-* How does Python SK compare to the C# version of Semantic Kernel?
+## How does Python SK compare to the C# version of Semantic Kernel?
 
-  The two SDKs are compatible and at the core they follow the same design principles.
-  Some features are still available only in the C# version, and being ported
-  Refer to the [FEATURE PARITY](FEATURE_PARITY.md) doc to see where
-  things stand in matching the features and functionality of the main SK branch.
-  Over time there will be some features available only in the Python version, and
-  others only in the C# version, for example adapters to external services,
-  scientific libraries, etc.
+The two SDKs are compatible and at the core they follow the same design principles.
+Some features are still available only in the C# version, and being ported
+Refer to the [FEATURE PARITY](FEATURE_PARITY.md) doc to see where
+things stand in matching the features and functionality of the main SK branch.
+Over time there will be some features available only in the Python version, and
+others only in the C# version, for example adapters to external services,
+scientific libraries, etc.
