Build from top-level project about f5-ci-docs HOT 4 CLOSED

I'm not sure if this is an issue or not.

I am building this repo with make html while in f5-ci-docs/docs

The paths are these:

1. f5-ci-docs/docs/f5-fpp/README.rst
2. f5-ci-docs/docs/f5-fpp/_includes/topic_kubernetes-notes.rst
3. f5-ci-docs/docs/f5-fpp/_static/example-service-flowpoint.yaml

1 contains .. include:: _includes/topic_kubernetes-notes.rst referencing 2
2 contains .. literalinclude:: _static/example-service-flowpoint.yaml referencing 3

1 correctly renders the content in 3, which is suprising. It shows that the relative root of the literalinclude is that of 1, and not 2 where the statement exists.

The problem here is that I can only include that content from a specific directory. To prove this to myself, I also include 2 from f5-ci-docs/docs/index.rst. That doesn't render correctly.

However,

from f5-ci-docs.

The docs say that the path should be relative to the file doing the importing, but this doesn't appear to be the case.

http://www.sphinx-doc.org/en/stable/markup/code.html#includes

from f5-ci-docs.

added to lightweight-proxy; see project Makefile.

from f5-ci-docs.

rST epilog needs to be controlled from f5-ci-docs to ensure consistency and easy updating across all docs.

from f5-ci-docs.