quarto-dev / quarto-dev/quarto-cli
Consider homogenizing or regrouping information on the authors/affiliations schemas in a single place
@cwickham is already working on this.
Since Sep 1, 2024.
- Dominant language
- JavaScript
- Stars
- 6k
- Forks
- 458
- Avg merge
- 1d 9h
- Merged PRs (30d)
- 41
Description
What would you like to do?
Give feedback or suggest an improvement
Description
Currently, the documentation details the authors and affiliations schemas in two different places:
- https://quarto.org/docs/authoring/front-matter.html#authors-and-affiliations
- https://quarto.org/docs/journals/authors.html
The two pages don't have the same level of details and clarity though. The front matter page has some sections that are more detailed but less clear in my opinion (e.g. the role section; see #10663). I'd suggest to regroup the common information on these pages in a single place to make it easier for the reader. Or at least clarify the role section on the front matter page with the text and examples of the /journals/authors one.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.