From 2c8dd42ae67d77dd34cdaf543886d2df63607c5b Mon Sep 17 00:00:00 2001 From: Eddie Knight Date: Mon, 22 Jul 2024 09:55:09 -0500 Subject: [PATCH 1/7] Added TAG Attribution guidelines Signed-off-by: Eddie Knight --- governance/tag-attribution.md | 63 +++++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 governance/tag-attribution.md diff --git a/governance/tag-attribution.md b/governance/tag-attribution.md new file mode 100644 index 000000000..34c7d28f5 --- /dev/null +++ b/governance/tag-attribution.md @@ -0,0 +1,63 @@ +# TAG Attribution Guidelines + +[Attribution] is the act of ascribing a work to a particular author. + +The TAG may be attributed with authorship of a work following a robust +community review and approval process. Depending on the document category, a +work will require different review processes before attribution is possible. + +Below is a list of works categories, and what will enable it to be attributed +as a TAG publication. + +1. Publications (whitepapers, etc) + - The document must follow all guidelines, protocols, and processes outlined + in the [publications] directory. +1. Presentations (conference talks, webinars, etc) + - The presentation must be made by a TAG Tech Lead or Chair + - The presentation content must be pre-approved by a majority of TAG Leads + - No significant concern has been left unaddressed by a TAG Tech Lead +1. Blogs (On the TAG site or elsewhere) + - The Blog must be directly connected to an initiative such as a whitepaper + or event. + - If the blog contains any opinions, advice, or recommendations, it follows + all guidelines, protocols, and processes outlined in the [publications] + directory. + +## Personal Attribution + +A TAG Tech Lead, Chair, or project may use their title in any internal or +external publication as they see fit. There is no restriction to this, but +the following examples will aid in clarity to avoid mistaken attribution. + +### Attribution Qualifier + +It is prefferable, but not required, that personally attributed works include +a qualifying statement if the CNCF or the TAG is mentioned in the author byline +or article content. + +> The author is a leader in CNCF's Technical Advisory Group for Security, + but this work is the sole opinion of the author and does not represent + any stance from CNCF or the TAG. + +### Good Examples + +These examples clearly delineate the author attribution from the author's role + +- R. Raccoon - Tech Lead, CNCF TAG Security +- R. Raccoon (Tech Lead, CNCF TAG Security) + +### Less Good Examples + +These examples leave room for misunderstanding whether the article was written +or approved by the TAG. + +- R. Racoon - CNCF TAG Security +- R. Racoon (CNCF TAG Security) +- R. Racoon, CNCF TAG Security +- R. Racoon, Tech Lead, CNCF TAG Security +- R. Racoon, TrashPanda Corp and TAG Security +- R. Racoon, TrashPanda Corp, TAG Security + + +[Attribution]: https://www.merriam-webster.com/dictionary/attribution +[publications]: /publications \ No newline at end of file From 5ab62e62d4b412eb068beeb4f0e89c001b5a5e7d Mon Sep 17 00:00:00 2001 From: Eddie Knight Date: Mon, 22 Jul 2024 09:58:58 -0500 Subject: [PATCH 2/7] typofix Signed-off-by: Eddie Knight --- governance/tag-attribution.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/governance/tag-attribution.md b/governance/tag-attribution.md index 34c7d28f5..8c37e2dda 100644 --- a/governance/tag-attribution.md +++ b/governance/tag-attribution.md @@ -25,7 +25,7 @@ as a TAG publication. ## Personal Attribution -A TAG Tech Lead, Chair, or project may use their title in any internal or +A TAG Tech Lead, Chair, or Project Lead may use their title in any internal or external publication as they see fit. There is no restriction to this, but the following examples will aid in clarity to avoid mistaken attribution. From 4a486455b15628b4dd3c96d7f1d481e4a54bf0bb Mon Sep 17 00:00:00 2001 From: Eddie Knight Date: Mon, 22 Jul 2024 10:53:52 -0500 Subject: [PATCH 3/7] Applying feedback Signed-off-by: Eddie Knight --- governance/tag-attribution.md | 1 + 1 file changed, 1 insertion(+) diff --git a/governance/tag-attribution.md b/governance/tag-attribution.md index 8c37e2dda..cba8d7552 100644 --- a/governance/tag-attribution.md +++ b/governance/tag-attribution.md @@ -45,6 +45,7 @@ These examples clearly delineate the author attribution from the author's role - R. Raccoon - Tech Lead, CNCF TAG Security - R. Raccoon (Tech Lead, CNCF TAG Security) +- R. Raccoon (CTO, TrashPanda Corp and Tech Lead, CNCF TAG Security) ### Less Good Examples From bb9001f1ebb823411cb71c5770979592b6e88408 Mon Sep 17 00:00:00 2001 From: Eddie Knight Date: Mon, 22 Jul 2024 10:54:41 -0500 Subject: [PATCH 4/7] Applying feedback Signed-off-by: Eddie Knight --- governance/tag-attribution.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/governance/tag-attribution.md b/governance/tag-attribution.md index cba8d7552..623320aae 100644 --- a/governance/tag-attribution.md +++ b/governance/tag-attribution.md @@ -31,7 +31,7 @@ the following examples will aid in clarity to avoid mistaken attribution. ### Attribution Qualifier -It is prefferable, but not required, that personally attributed works include +It is preferable, but not required, that personally attributed works include a qualifying statement if the CNCF or the TAG is mentioned in the author byline or article content. From 55fc24a375638d9ddfcead41754e10fba03c0836 Mon Sep 17 00:00:00 2001 From: Eddie Knight Date: Mon, 22 Jul 2024 10:57:11 -0500 Subject: [PATCH 5/7] fixing link Signed-off-by: Eddie Knight --- governance/tag-attribution.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/governance/tag-attribution.md b/governance/tag-attribution.md index 623320aae..ca128a887 100644 --- a/governance/tag-attribution.md +++ b/governance/tag-attribution.md @@ -61,4 +61,4 @@ or approved by the TAG. [Attribution]: https://www.merriam-webster.com/dictionary/attribution -[publications]: /publications \ No newline at end of file +[publications]: \ No newline at end of file From 41c313a11f26fa326316eb8e2434f9aa1eed0d99 Mon Sep 17 00:00:00 2001 From: Eddie Knight Date: Mon, 22 Jul 2024 10:57:37 -0500 Subject: [PATCH 6/7] fixing link Signed-off-by: Eddie Knight --- governance/tag-attribution.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/governance/tag-attribution.md b/governance/tag-attribution.md index ca128a887..f3dd1e574 100644 --- a/governance/tag-attribution.md +++ b/governance/tag-attribution.md @@ -61,4 +61,4 @@ or approved by the TAG. [Attribution]: https://www.merriam-webster.com/dictionary/attribution -[publications]: \ No newline at end of file +[publications]: ../publications \ No newline at end of file From c3a104e09c9470a3799906da2e20f56c1d2466d4 Mon Sep 17 00:00:00 2001 From: Eddie Knight Date: Mon, 22 Jul 2024 11:17:47 -0500 Subject: [PATCH 7/7] linting Signed-off-by: Eddie Knight --- governance/tag-attribution.md | 26 +++++++++++++++----------- 1 file changed, 15 insertions(+), 11 deletions(-) diff --git a/governance/tag-attribution.md b/governance/tag-attribution.md index f3dd1e574..b033e1073 100644 --- a/governance/tag-attribution.md +++ b/governance/tag-attribution.md @@ -10,18 +10,23 @@ Below is a list of works categories, and what will enable it to be attributed as a TAG publication. 1. Publications (whitepapers, etc) - - The document must follow all guidelines, protocols, and processes outlined + +- The document must follow all guidelines, protocols, and processes outlined in the [publications] directory. + 1. Presentations (conference talks, webinars, etc) - - The presentation must be made by a TAG Tech Lead or Chair - - The presentation content must be pre-approved by a majority of TAG Leads - - No significant concern has been left unaddressed by a TAG Tech Lead + +- The presentation must be made by a TAG Tech Lead or Chair +- The presentation content must be pre-approved by a majority of TAG Leads +- No significant concern has been left unaddressed by a TAG Tech Lead + 1. Blogs (On the TAG site or elsewhere) - - The Blog must be directly connected to an initiative such as a whitepaper - or event. - - If the blog contains any opinions, advice, or recommendations, it follows - all guidelines, protocols, and processes outlined in the [publications] - directory. + +- The Blog must be directly connected to an initiative such as a whitepaper + or event. +- If the blog contains any opinions, advice, or recommendations, it follows + all guidelines, protocols, and processes outlined in the [publications] + directory. ## Personal Attribution @@ -59,6 +64,5 @@ or approved by the TAG. - R. Racoon, TrashPanda Corp and TAG Security - R. Racoon, TrashPanda Corp, TAG Security - [Attribution]: https://www.merriam-webster.com/dictionary/attribution -[publications]: ../publications \ No newline at end of file +[publications]: ../publications