Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Styling section listing contributors #81

Closed
reschke opened this issue Jul 22, 2019 · 4 comments
Closed

Styling section listing contributors #81

reschke opened this issue Jul 22, 2019 · 4 comments

Comments

@reschke
Copy link
Contributor

reschke commented Jul 22, 2019

see also #1 and #19

Authors frequently want to include an appendix listing contributors in addition to authors.

While this is possible as just prose, it's not possible to style this in a way similar to the "Authors" section. It's debatable whether this is actually desirable, but we see cases where authors just use the <artwork> element to get what they want.

That said, https://tools.ietf.org/html/draft-flanagan-7322bis-03#section-4.11 says:

The Contributors section may include brief statements about the
nature of particular contributions (e.g., "Sam contributed
Section 3"), and it may also include affiliations of listed
contributors. At the discretion of the author(s), contact addresses
may also be included in the Contributors section, for those
contributors whose knowledge makes them useful future contacts for
information about the RFC. The format of any contact information
should be similar to the format of information in the Author's
Address section.

(emphasis mine)

This is currently impossible because we don't allow authors to control line breaks in prose.

A <br> element would fix this (but see #37).

An alternative way is implemented in rfc2629.xslt: https://greenbytes.de/tech/webdav/rfc2629xslt/rfc2629xslt.html#ext.element.contributor

@martinthomson
Copy link

#19 seems to be a better result.

@reschke
Copy link
Contributor Author

reschke commented Jul 22, 2019

Well, that one was closed. It also has the problem that it suggests an incompatible change, in that existing code that checks for <author> tags would be misled.

@reschke
Copy link
Contributor Author

reschke commented Sep 18, 2019

Note that the possibility of a "Contributors" section already was documented in https://tools.ietf.org/html/rfc7322#section-4.11>, dated September 2014. We really should find a way to produce that with the v3 vocabulary.

@martinthomson
Copy link

By which you refer to "The format of any contact information should be similar to the format of information in the Author's Address section." I agree.

reschke added a commit to reschke/draft-iab-xml2rfc-v3-bis that referenced this issue May 19, 2020
reschke added a commit to reschke/draft-iab-xml2rfc-v3-bis that referenced this issue May 19, 2020
jrlevine added a commit that referenced this issue May 19, 2020
Add <contact> as block-level element for use as child element of <section> (#81)
@reschke reschke closed this as completed May 19, 2020
jrlevine added a commit that referenced this issue May 28, 2020
add missing description for <contact> for #81
mnot referenced this issue in mnot/v3grammar Dec 29, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants