Warn about a known issue with the container

Author: Marek Suchánek

README.md

@@ -23,24 +23,26 @@ The `newdoc` tool generates pre-populated module and assembly files formatted wi
 
     Note that the Copr repository distributes packages only for *supported* releases of Fedora. If you have enabled the repository but the package fails to install, check if your Fedora is still supported.
 
-* To install `newdoc` as a Docker image, use the `docker` or `podman` tool. If you use `podman`, replace `docker` with `podman` in the following commands:
+* To install `newdoc` from source on a Linux distribution, on macOS, or on Microsoft Windows, use the `cargo` package manager:
 
     ```
-    $ docker pull mrksu/newdoc
+    $ cargo install newdoc
     
-    $ docker run mrksu/newdoc
+    $ newdoc
     ```
 
-
-* To install `newdoc` from source on a Linux distribution, on macOS, or on Microsoft Windows, use the `cargo` package manager:
+    For installing `cargo`, see <https://rustup.rs/>.
+    
+* To install `newdoc` as a Docker image, use the `docker` or `podman` tool. If you use `podman`, replace `docker` with `podman` in the following commands:
 
     ```
-    $ cargo install newdoc
+    $ docker pull mrksu/newdoc
     
-    $ newdoc
+    $ docker run mrksu/newdoc
     ```
+    
+    **Warning:** The container currently does not generate files properly. For details and a workaround, see [Issue #17](https://github.com/redhat-documentation/newdoc/issues/17).
 
-    For installing `cargo`, see <https://rustup.rs/>.
 
 ## Updating newdoc
 
@@ -50,16 +52,16 @@ The `newdoc` tool generates pre-populated module and assembly files formatted wi
     # dnf upgrade newdoc
     ```
 
-* To update `newdoc` from Docker, use the `docker` or `podman` tool:
+* To update `newdoc` from source, use the `cargo` package manager:
 
     ```
-    $ docker pull mrksu/newdoc
+    $ cargo install newdoc
     ```
 
-* To update `newdoc` from source, use the `cargo` package manager:
+* To update `newdoc` from Docker, use the `docker` or `podman` tool:
 
     ```
-    $ cargo install newdoc
+    $ docker pull mrksu/newdoc
     ```