[PATCH 1/2] docs: Update introduction in pci-addresses.rst

[Boris Fiuczynski]

Changing the introduction to bring the idea of this document better across.

Signed-off-by: Andrea Bolognani <abologna at redhat.com>
Reviewed-by: Boris Fiuczynski <fiuczy at linux.ibm.com>
---
 docs/pci-addresses.rst | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/docs/pci-addresses.rst b/docs/pci-addresses.rst
index 1d2dc8e5fc..7c8e9edd73 100644
--- a/docs/pci-addresses.rst
+++ b/docs/pci-addresses.rst
@@ -4,9 +4,12 @@ PCI addresses in domain XML and guest OS
 
 .. contents::
 
-When discussing PCI addresses, it's important to understand the
-relationship between the addresses that can be seen in the domain XML
-and those that are visible inside the guest OS.
+Looking at the configuration for a guest, it would be reasonable
+to expect that each PCI device would show up in the guest OS with
+a PCI address that matches the one present in the corresponding
+``<address>`` element of the domain XML, but that's not guaranteed
+to happen and will in fact not be the case in all but the simplest
+scenarios.
 
 
 Simple cases
-- 
2.25.1