Open points to discuss with documentation team

[jonas-rem]

We noticed the following points need further discussion while reviewing PRs. We should discuss this with the documentation team to understand the previous context of those decisions.

• Emphasizing words where it brings no benefit to the reader source: yocto: Add content to HEAD document #13 (comment)_
• Using named links source: yocto: Add content to HEAD document #13 (comment)_
• Should there be external documents/Links that e.g. explain Phytec's general Documentation structure (Chapter: "PHYTEC Documentation")? IMX8MP BSP Manual Head #15 (comment)
• In the pdf documents, there is a release version right below the title. This is the one from conf.py. I do not think this should be included in the pdf
• One page html vs. numbered headings vs. multiple page html layout source: yocto: Add content to HEAD document #13 (review)_

[mschwan-phytec]

@jremmert-phytec-iot Do you want to discuss this with the documentation department in person or via this issue?

[jonas-rem]

@jremmert-phytec-iot Do you want to discuss this with the documentation department in person or via this issue?

I think it would be best to discuss with them in person as a first step. But before that, let's merge the initial drafts of the Yocto documentation and the BSP documentation so that we have something to show. This issue should serve as a reminder of all open issues, feel free to add points.

[s-hemer]

IMHO emphasizing paths, commands and variable names in inline texts (and elsewhere) does bring a benefit to the reader. Somehow unfortunate that i.e. :file:`~/linux-imx/arch/arm64/boot/dts/freescale/|dt-carrierboard|.dtb` does not allow substitution.