github_exp_9518
This is an old revision of the document!
Table of Contents
2023 github experiment
GitHub Experiment 11 - RFC 9518 (draft-nottingham-avoiding-internet-centralization)
High-Level Summary
- RPC edited document in XML as usual.
- RPC forked the author's repo at the beginning of RFCED state. RFCED put in changes from the PE's diff to the author's markdown file using PRs per section (38 total PRs)
- Each AQ was an issue (15 total) - some later became PRs (see next point below).
- An issue was created for each document-wide/global edit to later be incorporated as a PR.
- The (single) author and ISE were invited as a collaborators.
- References were manually handled in XML after other PRs/Issues etc. resolved and markdown--> XML used.
Description
This eleventh experiment is an Independent Stream document (one author, 28 pages, not in a cluster). The ISE sent mail (9/13/2023) requesting that this document be a GitHub experiment, as would be a good candidate to work out ISE processes. The author agreed prior to the document entering the queue.
GitHub Setup
This experiment involved moving edits from an XML file to a markdown file using github for RFCED and AUTH48. In this experiment, the RPC controls the repo. Both pull requests and issue tracking were used.
Repository
Issue Tracking
- Initial number of issuses: 15
- Issue labels:
- rfced
Expert Review
AUTH48 Notes
- AUTH48 started 2023 Dec 6 and ended 2023 Dec 18. This document was published 2023 Dec 18.
Lessons Learned
- Switching between XML --> Markdown --> XML was confusing and time consuming.
- We only used the rfced label. Didn't know we needed the other labels added at RFCED.
- Using Issues to mention global edits and then PRs to implement them once authors agree.
- We figured out how to update the header/boilerplate to be Independent Submission in markdown. (See header of the markdown file at https://github.com/rfc-editor/draft-nottingham-avoiding-internet-centralization/blob/rpc-main/draft-nottingham-avoiding-internet-centralization.md).
Feedback
[awaiting reply]
github_exp_9518.1707846833.txt.gz · Last modified: (external edit)
