Confusing documentation names

[jidanni]

Description

[mcanouil]

@jidanni Thanks for the reports, they are genuinely appreciated.

That said, I'd like to ask you to take a moment to read the contributing guidelines available in both issues and discussions before opening further issues or discussions.

A few things worth keeping in mind:

• There is a documentation issue template designed specifically for such report and ask to include a link to the page in question and a clear description of what is missing or incorrect.
• A screenshot with arrows as the sole content of a discussion is not helpful, not for accessibility, and not for maintainers trying to reproduce or understand the problem. I would like to remind you to be mindful of the readers.

Important

Accessibility: To improve accessibility, please add alternative text to your screenshots. This helps all users, including those using screen readers, to understand the context of the images. A brief description can make a big difference! See Good Alt Text, Bad Alt Text — Making Your Content Perceivable.

Quality matters far more than volume here. A single well-written report is worth more than a handful of incomplete ones, and it makes it much more likely the issue will actually get resolved.

Please do read the guidelines. They exist to make things easier for everyone.
Thank you again for your reports.

[jidanni]

I wasn't sure that it was worthy of creating an issue.

The pages are
https://quarto.org/docs/journals/authors.html
https://quarto.org/docs/authoring/front-matter.html#authors-and-affiliations

[mcanouil]

I wasn't sure that it was worthy of creating an issue.

Unfortunately, I don't think the maintainers (I sure can't) can answer that with only a title "Confusing documentation names" and a screenshot with no explanation on what is confusing exactly, or eventually a proposal (always appreciated) to makes things clearer.
Without any explanation, it's very unlikely a resolution will be found.

Documentation issues are different from bug reports thus the deliberate issue template:

• https://github.com/quarto-dev/quarto-cli/issues/new?template=documentation.yml

[jidanni]

Yes, it's one big tangle
#14402
and I have no concrete suggestions.