search

asciidoctor / asciidoctor.org

:globe_with_meridians: Asciidoctor project site. Composed in AsciiDoc. Baked with Awestruct.
https://asciidoctor.org
Other
322 stars 805 forks source link

Misleading title in section 70? #792

Closed rockyallen closed 6 years ago

rockyallen commented 6 years ago

https://asciidoctor.org/docs/user-manual/#specifying-an-output-file

But when you read it, it isn't really about specifying an output file (which is covered in https://asciidoctor.org/docs/user-manual/#document-conversion), it is about using the Asciidoctor command in a pipe.

Rename to "Using asciidoctor as a filter"? or "Specifying an output file when reading from STDIN"?

mojavelinux commented 6 years ago

Thanks for pointing this out. You're right, this section is totally confused. Let's introduce a new chapter that covers the input and output options of the CLI. Then we'll move all related content underneath it, including a new section that covers piping content through the processor.