95 Matching Annotations
  1. Sep 2023
  2. May 2023
  3. Dec 2022
    1. Include one or both of these headers in your messages:

      Actually, if you include List-Unsubscribe-Post, then you MUST include List-Unsubscribe (both).

      According to https://www.rfc-editor.org/rfc/rfc8058#section-3.1,

      A mail sender that wishes to enable one-click unsubscriptions places one List-Unsubscribe header field and one List-Unsubscribe-Post header field in the message. The List-Unsubscribe header field MUST contain one HTTPS URI. It MAY contain other non-HTTP/S URIs such as MAILTO:. The List-Unsubscribe-Post header MUST contain the single key/value pair "List-Unsubscribe=One-Click".

  4. Nov 2022
  5. Oct 2022
  6. Sep 2022
  7. Mar 2022
    1. because client programmers will not always take the effort to read a long spec

      Because client programmers are pressed to read the full spec, we should not abuse and show respect for their time and attention.

  8. Feb 2022
  9. Jan 2022
    1. knows just how to make a film look good, using the language and grammar of the film elements that speak to the viewer and evoke emotional responses and reactions.

      great sentence!

    2. They

      I would suggest stating.... Editor usually start as ASSISTANT EDITORS..... (for clarity)

    3. mojo

      maybe with quotes, "mojo" or something more common like 'experience'

    4. audio footage

      Maybe use video and audio "recordings" ? audio footage doesn't sound right to me.

  10. Sep 2021
  11. Jun 2021
    1. In the context of git, the word "master" is not used in the same way as "master/slave". I've never known about branches referred to as "slaves" or anything similar. On existing projects, consider the global effort to change from origin/master to origin/main. The cost of being different than git convention and every book, tutorial, and blog post. Is the cost of change and being different worth it? PS. My 3 projects were using your lib and got broken thanks to the renaming. PS. PS. I'm glad I never got a master's degree in college!
    1. the benefits of GitHub renaming the master branch to main far outweigh any temporary stumbling blocks. He said the change is part of a broader internal initiative to add inclusive language to the company's systems. His team is also replacing whitelist and blacklist with allowlist and blocklist.
    2. "Both Conservancy and the Git project are aware that the initial branch name, 'master,' is offensive to some people and we empathize with those hurt by the use of that term," said the Software Freedom Conservancy.
  12. Apr 2021
    1. teaches players how to play while they play
    2. If you'd like to read more about the game's arguments, click here. 

      I'm not familiar with this term "arguments" used like this. Isn't this more referring to the motivation for this game?

    1. I'll tell you my intention right away, because the language difference between us may offend you. For those things I don't understand, I apologize in advance (if you don't need my apology and feel that my apology is offensive to you, I firmly withdraw my apology).
  13. Mar 2021
    1. antiphrasis, which refers to the usually ironic or humorous use of words in senses opposite to the generally accepted meanings, such as in a phrase like "an ancient creature 2 days old."
  14. Feb 2021
    1. Redmond suggests nuking 'profanity, geopolitical, diversity' terms from browser source
    2. Allowlist, not whitelist. Blocklist, not blacklist. Goodbye, wtf. Microsoft scans Chromium code, lops off offensive words
    3. a proposal to cleanse the open-source code of "potentially offensive terms."
    4. a suggestion by Microsoft to “cleanup of potentially offensive terms in codebase” aims to rid the software blueprints of language such as whitelist (change to allowlist), blacklist (change to blocklist), “offensive terms using ‘wtf’ as protocol messages,” and other infelicities.
    5. In May, Microsoft announced AI features in Word that, among other features, will emit “advice on more concise and inclusive language such as ‘police officer’ instead of ‘policeman.’"
    1. Good intentions, but I doubt there's any relation of the origin of the terms blacklist/whitelist to race. There are many idioms and phrases in the English language that make use of colours without any racial backstories. I haven't met any black person (myself included) who was ever offended by the use of "blacklist".
    2. Regardless of origin, allow/deny are simply clearer terms that does not require tracing the history of black/white as representations of that meaning. We can simply use the meaning directly.
    1. note that TRB source code modifications are not proprietary

      In other words, you can build on this software in your proprietary software but can't change the Trailblazer source unless you're willing to contribute it back.

      loophole: I wonder if this will actually just push people to move their code -- which at the core is/would be a direction modification to the source code - out to a separate module. That's so easy to do with Ruby, so this restriction hardly seems like it would have any effect on encouraging contributions.

    1. We really don’t think laws and “imaginary property” have any place
  15. Jan 2021
  16. Nov 2020
    1. This overloaded word is also non-jargon for a proper morphism.
    2. notion

      I don't feel very comfortable with this choice of wording, perhaps because the dictionary definition includes such wishy-washy definitions as "A belief or opinion." "An impulse or whim."

      Why not choose a better word like "property"? Which is what they called it here, for example.

      (Even "concept" or "idea", though just as vague, might be better than notion?)

    1. Those frameworks are used in a similar fashion, but conceptually use quite different approaches (Vue is a more traditional one, a library, and Svelte is a "dissapearing framework").

      interesting wording: Svelte is a "disappearing framework".

    1. However, those descriptors gave a bit too much flexibility/dynamism to the class shape in order to be efficiently optimizable.

      I think this:

      However, those descriptors gave a bit too much flexibility/dynamism to the class shape in order to be efficiently optimizable.


      However, because those descriptors were gave so much too much flexibility/dynamism to the class shape, it could not be be efficiently optimized.

      rather than:

      In order to be efficiently optimizable, those descriptors gave much flexibility/dynamism to the class shape.

      In other words that flexibility/dynamism hindered optimization; it wasn't for the purpose of optimization (as "in order to be" could be interpreted as).

      The "too much" wording also contributed to the confusion for me.

      But maybe just dropping "in order" would have been enough for me:

      However, those descriptors gave a bit too much flexibility/dynamism to the class shape to be efficiently optimizable. or However, those descriptors gave a bit too much flexibility/dynamism to the class shape for them to be efficiently optimizable.

  17. Oct 2020
  18. Sep 2020
    1. Svelte offers an immutable way — but it’s just a mask to hide “assignment”, because assignment triggers an update, but not immutability. So it’s enough to write todos=todos, after that Svelte triggers an update.
  19. May 2020
    1. of, relating to, or being a grammatical case or form expressing means or agency

      I really need an example of this!

      It seems unusual that they specifically mention "a grammatical case or form". I've never seen a definition before that is anything like this one.

      How is this different from definition 1?

    1. to bypass work

      What does "work" mean here? I think maybe they mean to bypass profiling?

  20. Aug 2019
    1. A lot of us will use “outcome” and “impact” interchangeably, but the truth is, they are different

      For clarity and to promote easier reading, consider revising this sentence so that the subjects are more explicitly identified. For instance, I'd suggest revising this section's introduction to something like:

      "When we talk about research or program evaluation, a lot of us tend to use the terms 'outcome' and 'impact' interchangeably. The truth, however, is that these are two distinct terms, and it's important to understand the differences between them."

    1. Explain defining features of content analysis as a strategy for qualitative data analysis and when it is most effectively used

      These two learning objectives are perhaps best presented separately, since they're both important and both represent major goals for readers. Also, the way the sentence currently reads, it's not technically clear what is meant by "when it is most effectively used." Grammatically, "it" could refer to qualitative data analysis OR content analysis, depending on how the reader interprets this sentence. Consider revising to something like:

      "Learners will be able to:

      Explain defining features of content analysis as a strategy for analyzing qualitative data.

      Determine when content analysis can be most effectively used."

    2. in the act of qualitative data analysis

      As a student reader, I think "in the act" is perhaps too formal and, at least from my perspective, clashes somewhat with the overall tone of previous chapters. Perhaps we can revise to something like:

      "Identify how researchers can conduct ethically responsible qualitative data analysis."

    1. These responses to what you are learning

      Though I do understand (I think) what the author is trying to say here, perhaps a slight change in wording would clear this sentence up a bit. Beginning this sentence with "These responses..." was confusing perhaps because I first interpreted the word "responses" as the answers participants provided during the hypothetical interview. Perhaps revise to something like:

      "Your emotional and intellectual reactions to what you learn during an interview may lead you to consider pursuing a slightly different line of questioning. You might highlight or de-emphasize certain aspects of the interview. Your personal reactions to what happens as you collect data are important and may influence your work."

    2. As we are thinking about going out in the world to gather data, I think it can be helpful to think about the data that is shared with us a resource.

      Great point about conceptualizing shared data as a resource. This is an important and helpful way for researchers to think about the information they get from participants. However - the repetitive use of the word "think" in this sentence threw me off a bit. Perhaps revise to something like:

      "As we're thinking about going out into the world to gather data, it may be helpful to conceptualize the data that is shared with us as a resource."

    3. Explain special considerations for researcher that accompany the collection of qualitative data

      This wording might be a bit confusing. Perhaps revise to something like:

      "Explain the special considerations researchers should keep in mind as they design qualitative studies and collect qualitative data."

    1. Emergent design is the idea that some decision in our design will be dynamic and change as our understanding of the research question evolves as we go through the research process.

      May want to revise this sentence a bit for clarity. Perhaps revise to something like:

      "Emergent design is the idea that our initial research design is dynamic, and may change as we go through the research process and our understanding of the research question evolves."

      (I think what threw me off a bit was the phrase "...some decision in our design" - this is the main part I would suggest tweaking for clarity.)

    2. The researcher who schedules interviews with public assistance recipients to capture their experience after a legislation drastically changes their requirements for receiving benefits relies on the verbal data shared with them.

      I think this important point could perhaps be more clearly explained/worded. I think that if we separately identify the researcher's topic of interest and research approach, we'll bring some added clarity to this hypothetical scenario. Here's how I might revise this sentence to clarify core concepts and explain links between ideas:

      "Let's say, for example, that a researcher wants to learn about the experiences of public assistance recipients after federal legislation drastically changes the requirements for receiving benefits. This researcher might schedule interviews to capture verbal data shared by participants. The researcher relies on the data he or she may capture as participants talk about their personal stories, experiences, and reactions to the federal legislation."

      *The above revision suggestion references the "personal stories" of participants - which could be a good way to naturally reiterate this chapter's earlier points about qualitative research focusing in part on the stories of research subjects.

    3. Because of this, as you are reviewing the sections below, think about accessible alternative sources of data that will still allow you to practically answer your research question and I’ll try to provide some examples to get you started along the way.

      May want to consider breaking this sentence up into 2 separate parts. For example, could revise to something like "Because of this, as you are reviewing the sections below, think about accessible alternative data sources that will still allow you to practically answer your research question. I'll try to provide some examples to get you started along the way."

      The above suggested revision would preserve the informal tone of this section and perhaps more clearly emphasize the main point about considering alternative data sources.

    4. it may be shaping the study

      Consider revising to something like "...and how these may influence or shape a study"

    5. Because of this, I think we need to take special care to treat these stories as sacred and we go about asking for people to share them, we need to do so humbly.

      May want to break this sentence into 2 separate statements to emphasize this important point. Could perhaps revise to something like "Because of this, we need to take special care to treat these stories as sacred. As we go about asking for people to share their stories, we need to do so humbly."

    6. how many are represented in your sample

      This might just be a personal preference, but I stumbled a bit with the wording here. Perhaps we can revise to something like "...and this is likely to affect how the larger community is represented in your sample" or "...and this is likely to limit focus group participation, which in turn may affect how the larger community and target population are represented in your sample."

  21. Jan 2019
    1. What are the symptoms of vaginal cancer?

      Change to "What are the signs and symptoms of vaginal cancer?" What are the signs is searched more than what are the symptoms.

    2. Vaginal Cancer Risk Factors

      Change to "What Causes Vaginal Cancer - Risk Factors"

  22. Jun 2016
  23. www.glottotopia.org www.glottotopia.org
    1. I here

      Unclear what this is supposed to mean.

    2. Attested in the corpus is only the one example in (53),

      The only example attested in the corpus is (53),

    3. Syntactically, not only nouns, personal pronouns, demonstratives, or nounphrases can take the possessor or possessum slots. In addition, these slots canbe filled by verbs. Further, the possessum slot can be taken by mid-range quanti-fiers, temporal adverbs, or prepositional phrases. Finally, the possessum can beomitted.

      This entire paragraph is redundant. Remove it.

    4. subscript

      They're superscripts in (34).

    5. unattested

      Perhaps this is explained in another chapter, but it's confusing that you say it's unattested and then give an example (which means that it is most certainly attested). Unattested in a given corpus?

    6. details


    7. both

      Replace "both" with "the" here.

    8. Asfor the uses


  24. Apr 2014
    1. which leads into our key step in creating a more collaborative and open scientific community.

      By "key step" here do you mean "goal"? This might be more clearly written as something like "which enables our goal of creating a more collaborative and open scientific community"?