Re: [tao-discuss] New Version of the Tao of the IETF

[Niels ten Oever <[e-mail]>]

Thanks Corinne,

Am sending this to tao-discuss, where the Tao is being discussed, to ensure your valuable review does not get lost.

I made the changes in:
https://github.com/nllz/Tao-of-the-IETF/blob/master/Tao.md

@Greg and Kathleen - are these changes minor enough that we can direcly change them, or should we wait for a new version before we can push this?

Please find my comments in-line:

On 9/23/19 6:35 PM, Corinne Cath wrote:
> Hi,
> 
> Thanks for all the work Niels & Kathleen. Some nits: 
> 
> 1. has the Tao been updated to include the new mailinglist that arose out of the flurry of emails on the ietf@ietf mailing list? should it?

Sorry, I have missed this conversation - which emaillist are you referring to?

> 
> 2. related, the current text says that "the ietf discussion list is unmoderated" is that correct? it seems like there is some moderation going on, with interventions from the SAA's (leaving aside the debate about how much moderation is good moderation) which you mention later on in that paragraph.
> 

I think the colloquial understanding of 'unmoderated mailinglist' is:

A moderated mailing list requires each subscriber and message to be approved by the "owner" of a list.

(from: https://www.calvin.edu/~rbobeldy/tutorials/email/elistserv4.htm)

In that sense ietf@ietf is unmoderated.

> 3. "For many people, IETF meetings are a breath of fresh air when compared to the standard computer industry conferences." I am sure this is true, yet  for many people IETF meetings are not necessarily the most pleasant of places, as was reflected in the debate about newcomer experiences during the plenary some 3 or 4 IETFs ago? I understand what you are saying - but maybe some text can be found that takes both those extreme ends into consideration?
> 

Isn't that addressed a couple of paras later when we write:

Newcomers to IETF face-to-face meetings often expect them to be like other standards bodies, or like computer conferences. Fortunately, many new attendees get quite animated about how much fun they are having. On the other hand, IETFers can sometimes be surprisingly direct, sometimes verging on rude. To build a climate in which people of many different backgrounds are treated with dignity, decency, and respect, the IETF has an <a href=“https://www.ietf.org/blog/ietf-anti-harassment-policy/”>anti-harassment policy</a>y, <a href="https://tools.ietf.org/html/rfc7154”>guidelines for conduct</a> and an <a href="https://www.ietf.org/contact/ombudsteam/“>ombudsteam.</a>.


> 4. s/ombudsteam/Ombudsteam
> 

Thanks, will fix

> 5. "If you are participating an IETF meeting for the first time">> insert "in" an 
> 

Thanks, will fix

> 6. s/high volumen/high volume
> 

Thanks, will fix

> 7. s/to the chairs of the working group your/you are
> 

Thanks, will fix

> 8. Okay granted this one is a bit of a gripe, but "dress for the weather" should maybe be dress for hotel A/C and/or the weather, but definitely the A/C, because that one is a given.  

I made that mistake several times as well. Can I propose the following:

At meetings people generally dress informally. Newcomers are sometimes out of place when they show up Monday morning in suits. The general rule is "dress for the weather" (unless you plan to work so hard that you won't go outside, in which case, "dress for comfort (and the hotel A/C!)" is the rule!).


> 
> 9. "3.6 Seeing Spots Before Your Eyes", this strikes me as a Dutchism but maybe I am wrong? Either way it make more sense to change it to "seeing dots"?
> 

This hails back from a time before a Dutch editor, so I think it is not a Dutchism. Can other people weigh in on this?

> 10. (Members of the press wear orange tinted badges with the word 'press' on it.) s/it/them bc badges = plural
> 

Good point, will fix.

> 11. I am a bit confused about this language re:what the terminal room is for: "Although preparation far in advance of the meeting is encouraged, there may be some unavoidable "last minute" things that can be accomplished in the terminal room." makes it sounds a lot more exciting than I have found it to be: a quiet working space where people can print stuff or complain about the network.
> 

Not sure what is confusing here? What could the terminal room be more?

> 12. s/If sponsorship for it is secure/ If sponsorship for it is secured
> 

Thanks, will fix.

> 13. "Small-sized agendas are available for pickup at the registration desk for those with good eyesight who want to keep a copy in their pocket or attached to the back of their badge." Not sure this is necessary: "for those with good eyesight"
>  

This is because the print on these agendas is very small.

> 14. s/behooves/behoves
> 

Thanks, will fix.

> 15. s/This is a hopefully-final time fo/ This is a hopefully-final time for
> 

Thanks, will fix.

> 16. s/and your more likely to receive comments and feedback on your work/ and you are more likely to receive comments and feedback on your work.
> 

Thanks, will fix.

> 17. s/query is not availble/ available 
>  

Thanks, will fix.

> Hope this is helpful!
> 

Yes, very helpful! Thanks a lot for this thorough review!

Best,

Niels

> CCS
> 
> 
> On Thu, May 23, 2019 at 6:45 PM Niels ten Oever <[e-mail] <mailto:[e-mail]>> wrote:
> 
> 
>     On May 22, 2019 19:17, Job Snijders <[e-mail] <mailto:[e-mail]>> wrote:
>     >
>     <<snip>>
>     >
>     > Ps Would it be possible to make the Table of Contents listing clickable URIs to anchors, so that one can link directly to a section or paragraph?
>     >
> 
>     Fixed!
> 
>     > On Wed, May 22, 2019 at 19:05 Niels ten Oever <[e-mail] <mailto:[e-mail]>> wrote:
>     >>
>     >> Dear all,
>     >>
>     >> Since 1993 the Tao of the IETF has functioned as a guide for new attendees to the IETF. Over time both the IETF and the Tao have changed. The last revision of the Tao was in 2012, which led us to believe it might be time for a new version. This new version is what we would like to present to you today.
>     >>
>     >> https://ietf.org/tao.html
>     >>
>     >> We, the editors, have built on the work of great editors before us, and benefited greatly from suggestions, comments, and reviews from the community in general, and from the tao-discuss list [0] and the IESG specifically.
>     >>
>     >> We hope you will deem the new version of the Tao an improvement, and above all we hope this will help and stimulate new participants to become part of our community.
>     >>
>     >> Translations of previous versions of the Tao [1] have been contributed by several organizations. If you or your organization would be interested in contributing a translation of this updated version, please contact the IETF Chair.
>     >>
>     >> If you have comments, questions or suggestions, these are all very welcome on the tao-discuss list [0], and we are also very happy with suggestions in the form of pull requests on Github [2].
>     >>
>     >> Best,
>     >>
>     >> Niels ten Oever & Kathleen Moriarty
>     >> Editors of the Tao of the IETF
>     >>
>     >> [0] https://www.ietf.org/mailman/listinfo/tao-discuss
>     >> [1] http://www.ietf.org/tao-translations.html
>     >> [2] https://github.com/nllz/Tao-of-the-IETF/blob/master/Tao.md
>     >> --
>     >> Niels ten Oever
>     >> Researcher and PhD Candidate
>     >> Datactive Research Group
>     >> University of Amsterdam
>     >>
>     >> PGP fingerprint    2458 0B70 5C4A FD8A 9488 
>     >>                    643A 0ED8 3F3A 468A C8B3
>     >>
> 
> 
> 
> -- 
> Corinne Cath - Speth
> Ph.D. Candidate, Oxford Internet Institute & Alan Turing Institute
> 
> Web: www.oii.ox.ac.uk/people/corinne-cath <http://www.oii.ox.ac.uk/people/corinne-cath>
> Email: [e-mail] <mailto:[e-mail]> & [e-mail] <mailto:[e-mail]>
> Twitter: @C_CS

-- 
Niels ten Oever
Researcher and PhD Candidate
DATACTIVE Research Group
University of Amsterdam

PGP fingerprint	   2458 0B70 5C4A FD8A 9488  
                   643A 0ED8 3F3A 468A C8B3