@@ -25,6 +25,32 @@ including
2525A small test case (just a few lines) is ideal. If your input is large,
2626try to whittle it down to the minimum necessary to illustrate the problem.
2727
28+Out of scope?
29+-------------
30+
31+A less than perfect conversion does not necessarily mean there's
32+a bug in pandoc. Quoting from the README:
33+
34+> Because Pandoc's intermediate representation of a document is less
35+> expressive than many of the formats it converts between, one should
36+> not expect perfect conversions between every format and every other.
37+> Pandoc attempts to preserve the structural elements of a document, but
38+> not formatting details such as margin size. And some document elements,
39+> such as complex tables, may not fit into Pandoc's simple document
40+> model. While conversions from Pandoc's Markdown to all formats aspire
41+> to be perfect, conversions from formats more expressive than Pandoc's
42+> Markdown can be expected to be lossy.
43+
44+For example, both docx and odt can represent margin size, but because
45+pandoc's internal document model does not contain a representation of
46+margin size, this information will be lost on converting from docx
47+to odt. (You can, however, customize margin size using `--reference-odt`.)
48+
49+So before submitting a bug report, consider whether it might be
50+"out of scope." If it concerns a feature of documents that isn't
51+representable in pandoc's Markdown, then it very likely is.
52+(If in doubt, you can always ask on pandoc-discuss.)
53+
2854Fixing bugs from the issue tracker
2955----------------------------------
3056