181 Matching Annotations
  1. Jul 2020
  2. Jun 2018
    1. I am hoping for enough space to try it out.

      When experiments have gone awry (e.g., expansion of Wikipedia Education Program to India), the big concern has been the commitment of the project organizer to addressing the negative impacts of the experiment.

      I'd suggest you assert some familiarity with the REward Borad, the ongoing debate over compensated contributions, and the Education Program/Education Foundation.

    2. It’s an experiment

      I suggest you start by making the case that the intent is to do something that furthers Wikipedia's mission (both in expanding/improving content, in an area revealed to be lacking by academic research; and also, in terms of drawing in new editors, and guiding them in Wikipedia's standards and etiquette in the process).

      "It's an experiment", while true, is not persuasive or comforting to a skeptic.

    3. To further avoid conflict of interest

      I think it's good practice, but the primary motivator really to avoid COI? Seems to me it's more to avoid messy disagreements about how much work is put in. Can you just delete this phrase? The rest of the section is great.

    4. If you have any conflicts of interest (for example, if you work for Room to Read) you should disclose that, or, ideally, opt out.

      Clarify. I think what you want to say here is, if you work for Room to Read, and edit Wikipedia in connection to the project, you MUST disclose your connection, you MUST opt out of donations based on your connection, but otherwise are welcome and encouraged to participate. RIght?

      Working for a newspaper seems like a different kind of COI, and maybe needs a different statement. For instance,

      • MUST disclose connection IF working on articles on your own paper or direct competitors (per WP terms of use)
      • ENCOURAGED to work only on unrelated articles, at least until up to speed
      • No special requirements re: payments to R2R
    5. I am working on a current project where a donor will donate a certain amount to a specific charity (Room to Read) for every article completed on a subject (in this case thousands of local newspapers without an article). I don’t have any connection to Room to Read or any of the newspapers in the project. I don’t receive any money from the donor. The donation is not in my name. My participation in the project is primarily based on my desire to improve the information environment with regard to coverage of local newspapers, though helping young girls in developing countries to read is a nice side effect. You can read more about the challenge here.

      I'd reverse the order/emphasis: This should be primarily a statement of "here's a project I support" and put the disclaimer stuff at the end. Don't go out of your way to invite attack.

    6. We just think teaching young girls to read in developing countries while making Wikipedia better is a good thing.

      I'd nix this, sounds too apologetic. I think you've amply and convincingly talked about why it's a good idea on your blog already.

    7. Neither the donor nor the project organizers have any financial interest in Room to Read (or in the local newspapers in the project).

      I would put this in fine print at the bottom. No need to emphasize.

    8. 1,000 newspaper articles complete with infoboxes by December 15, 2018

      A word or two about how you came to that number? I believe you told me Eni's research revealed 4,000 newpapers without articles...

    9. note they contributed work toward the challenge on their user page

      I'd make this more general -- you want people blogging, tweeting, and facebooking about it, don't you?

    1. flagged for deletion

      I'd remove this. YOu'd be amazed how frivolously some things are flagged for deletion. But, maybe there's something else to substitute to give a specific criterion.

    2. links

      Will there be a public and/or private venue for people to ask questions, get help, and discuss challenges they're working through? How about a list of resources and reference materials?

    3. Contents

      Needs lead section/overview (I'm sure you realize) As of now, the broad vision seems absent from the document, and I think it's important and should feature prominently. Express the goals and the supporting research right up front.

    4. encouraged

      I'd be happy to make a short, project-specific screencast on how to do it, if you'd like. It'd be good to have resources available for people to do this.

    5. all pages must include:

      Good list. A couple things to consider: (a) For contests, people are used to having very specific criteria. Maybe better to say "include at least 10 of the following 12" than to say "include all but here are a couple possible exceptions". That way people know if they "qualify".

      (b) this one is somewhat in tension. What if no [[WP:RS]] exist for some of these items? You should probably speak to that explicitly: "Abandon this stub and start an article on a new paper instead," or "Do the best you can and document the shortcomings on the talk page," or...what?

    6. Criteria for Newspaper Inclusion

      Needs slightly more clarity about the overlapping criteria (Wikipedia's criteria vs. your project's criteria), and maybe some subtle softerning of language.

    7. initial pilot

      If you're going to describe it this way, you should really include a bit more info about what a next phase might look like. Assume there are at least a couple people out there who will assume the worst, and make noise about it. More info about the overall vision will help.

    8. To introduce students and citizens to the process of editing WIkipedia.

      Say a little more? Seems there are two kinds of goals here: (a) recruiting and retaining editors (holy grail) and (b) increasing literacy about how Wikipedia and wikis work. Maybe two separate bullets?

    9. To increase the quality and reliability of Google "panels" and Wikipedia articles to web readers investigating a paper's credibility.

      Consider reversing order (put Wikipedia first)

    10. To model a new (or somewhat new) form of partnership between researchers, educators, and public supporters of the Wikipedia community.

      This could probably use a little work

  3. Jul 2017
    1. The latest storage drivers from your storage controller manufacturer must be installed

      Probably worth checking this. I can walk you through it, but it'll take a little more digging for me.

    2. If the user intends to start the computer from one of these large disks, the system’s base firmware interface must use the Unified Extensible Firmware Interface (UEFI) and not BIOS.

      Does NOT apply, you don't need to use this as a startup drive.

  4. Jun 2017
    1. or just “lurk” in the background, think about what I have to say and share when you feel comfortable.

      This, I think is obvious...probably better to leave it unsaid, people will lurk if that's what they want without prompting.

    2. The Emerson Street House

      Probably best to give a strong conclusion, reiterating the reason for eliminating CCB, and suggesting what the reader can do to bring that about, or some call to action. I'd put this paragraph in italics to indicate it's an offer separate from the main thesis of the piece.

    3. Owner’s Reps are becoming more common in the construction industry, replacing the need for the CCB.

      This seems like an important point, which could use more explicit articulation.

    4. Terminating 63 public employees is never an easy decision

      Personally, I find this point rather spurious...but I suppose many would see it as important. Probably good to include it, but three paragraphs and that level of detail seems like too much for me. Just because you want to eliminate an agency doesn't make you responsible for anticipating every possible future job of every employee.

    5. At $50.00 an hour, former CCB employees are affordable as compared to Portland lawyers, where the minimum hourly rate seems to be $300.00 an hour.

      I don't understand the relevance of this point...eliminate it?

    6. $16,674,481 and 63 positions from the 2017-2019 Total Expense Budget and $16,674,481

      I'm unclear on what you're proposing -- eliminating both expenditure AND revenue? In identical amounts? Does CCB precisely cover its own expenses through fees that should be eliminated...??

    7. I propose

      Sequence issue -- you should make a clear case not only why CCB was useless in YOUR case, but also why that is more broadly indicative of its (lack of) value, before making your proposal.

      One problem to avoid is, you don't want your reader to develop the impression that your goal is based on sour grapes. It's possible for the CCB to fail you, but to have value more generally; can you more clearly establish why it doesn't?

    8. hired an Owner’s Representative

      This may be true, but understanding it requires more industry knowledge than I (or maybe much of your intended audience) has. I don't know what an Owner's Representative is, or anything about the conditions that would lead you to hire one.

    9. My father operated on trust – a man’s word is his bond – which is how I learned construction

      I find this part a little hard to digest. "Operating on trust" is a complex position; my guess would be that your father was well positioned to know where to place his trust, based on deep relationships. I don't think you're in a position to indict the concept of operating on trust broadly -- what it looks like to me (based on my admittedly limited info) is that you merely placed your trust in the wrong company(s).

    10. construction defects

      This phrase throws me a little. Were they claiming that the defects long predated their involvement? If so, is that really a problem -- were the contractually obligated to deal with those issues? Was their claim inaccurate?

    11. “Gaslighting” and bullying by lawyer.

      I think to be compelling to a broad audience, this would need to be established with a lot of carefully-presented specifics.

    12. My Terrible Experience with Passive Home Construction

      This post combines three theses into one. Overall, I'd recommend pulling out three separate posts, which may refer to one another, and optimizing each:

      1. The challenges of building a passive house
      2. Broadly, the challenges of dealing with regulatory agencies and service providers
      3. Criticism of CCB, and policy/reform recommendation(s)

      You don't really need to write all three, of course...that's up to you. The one that interests me most is #3, and I'd suggest you focus your efforts on zeroing in on that one.

      Of course, the titles should be closely tailored to each, to appeal to the right audience and to clarify the focus.

    13. Below is a video

      This is a wonderful video. However, at least from the perspective of understanding the issues with CCB, the specifics of the narrative arc from "collaborative partner" to adversary make the story harder to follow. If it's important to you to document this betrayal of trust, you writing a separate piece focusing on this is the way to go; but I see this as maybe the least important focus, relative to the other points you're making.

    14. CCB mediator

      I'm a little unclear overall: was the mediator somebody unfamiliar with construction regulation? Do you want to accuse CCB of appointing somebody unqualified?

    15. took 4 months

      Do you want to highlight the slow-moving aspect? If so, hit the point harder...but consider leaving it out, or at least leaving it out of the initial framing of the CCB issues.

    16. There were numerous issues with my house

      You'd do well to clarify which issues were attributable to whom. Were these all Birdsmouth's fault? Or did it span several contractors?

    17. My father, an underground and solid waste contractor in Boston, conducted his business in an unregulated environment before OSHA.

      I like the personal angle, but you could do a bit more to draw out why it's significant. How did OSHA change the world in which your father operated? How would the establishment of CCB (or something similar in Massachusetts) have impacted his business model?

    18. The wow factor for me has been learning how the builders, architects, and contractors that I trusted to serve my best interests, were only lining their pocket books. Quality and care were secondary to money, and the goal of the project seemed to transition from building my home, to getting a project done as cheaply as possible, while charging me top dollar.

      I'd skip this point as well, or at least reframe it a bit. Money is the "bottom line" for most businesses; simply being motivated by money is not a bad thing in many people's eyes. An unethical approach is a problem, but that's not how you're framing it here.

    19. how much I have learned

      I'd avoid framing your piece(s) in terms of how much you have learned. Of course, the perspective of somebody who has recently learned something makes for great and useful writing; but drawing attention to that fact can actually undermine perception of your expertise, for some readers.

    20. build out the final touches of the Emerson Street House (ESH),

      I suggest you take a "lighter touch" in these pieces to your specific project. Of course you will want to draw attention to ESH; but with this topic, complexity is your biggest challenge in getting through to the reader, and specifics like these sadly serve to increase the amount of information the reader has to hold.

  5. May 2017
    1. outlets

      Two points made late in the piece should be moved or echoed in the lead paragraph:

      1. Authors failed to consider nature of "conflict" and whether it was actually conflict,
      2. It's to late to get the story right in the popular press.
  6. Jan 2017
    1. This opinion piece is written in his personal capacity as a volunteer Wikimedian, and does not necessarily reflect the Foundation's views.

      While I realize the Signpost has run notes like this in the past, I feel we should not. I do not recall seeing similar disclaimers from professionals writing op-eds in any other publication; and I don't think it conveys information useful to our readers. I prefer to keep these disclaimers short and relevant. (If anybody expresses confusion, or for any reason at all, I don't object to your pointing it out in the comment thread.)

    2. But you should start thinking about them not just as opportunities to change people into being Wikimedians, but also as an opportunity to change your own project

      This is good, but I feel that with a few more words, or another sentence, you might be able to land the point more strongly in the conclusion.

    3. your job

      It seems to me your piece raises the QUESTION of what the organizer's job is, and suggests that they might define it in various ways (either "to generate Wikiepedians" or "to report bugs" or a blend, or other things). So stating "your job" uncritically seems overly simplified here.

    4. there is a chance that this problem will be fixed in the software

      If I'm reading your overall piece correctly, THIS is your thesis -- so it's strange to have it come AFTER the point about a human voice. Reverse?

    5. Furthermore, if not watched, such people will probably remain silent and go away

      In my opinion (and I realize this is not my op-ed, feel free to ignore) this is the predominant point.

    6. these people aren't stupid and that it's never their fault

      This is a bit jarring -- I think many readers will think, "why would I think they're stupid, or that it's their fault? (I know that in practice many Wikipedians may ACT that way, but I believe very few would literally hold this view.) Is there another way to phrase?

    7. Observing new users of Wikipedia and other projects and learning about the technical and social challenges they face

      I read this as the thesis sentence; ideally, it should come sooner than the third paragraph.

    8. I reported them as software bugs

      Some of our readers may have no knowledge of Phabricator etc. Might be worth expanding to a separate paragraph, to describe why this is valuable, and offer at least a brief note on how to do it.

    9. right-clicking

      Perhaps add "in Visual Editor"? If not present, the reader has to click the link to understand what you're talking about, since right-clicking works in most places for this purpose.

    10. misunderstood the context

      I know, and agree with, what you're getting at here; but a critical reader will likely seize on this as a point of contention. Is there a way to state it more clearly as a problem?

    1. good

      I would delete -- lessen the sense that this is you conveying your opinion, and I don't think "good" actually adds much here. I think it's still quite complimentary to them to say they provided an overview.

    2. 700

      Anything you can state (either via links in the doc, or to me) that justifies your numbers will be helpful. We should fact-check all specifics, and we're pretty spread thin, so the more you can help me understand your reasoning, the better.

    3. constructively and harmoniously

      I think the piece demonstrates this clearly; but the more it's stated explicitly in the lead, the more it reads like an opinion piece, the less like a news piece. I'd urge you to reduce the evaluative phrasing, I think the piece will have a greater impact; but this is just a suggestion, not a requirement. Do with it as you like.

    4. By now the article has become one of the most comprehensive lists of these marches available online, with the over 700,000 people who read it over the last week able to use it to get an accurate sense of the scale of the events that took place.

      You've buried the lead! By my reading, this is the heart of the piece. Can you work this info into the first couple of sentences?

  7. Dec 2016
    1. I'm sorry to say, I have no idea what this graphic is trying to communicate. The labels along the bottom are meaningless to me. Can it be more explicit in some way?

    2. “I'd love to hear more from the Tool Labs community on the 'why' here,” said Davis

      This is excellent -- can we include a suggestion about how to best reach him? Wiki talk page, email...?

    3. Davis did note that there may be some recency bias as the period before the 2016 survey was relatively stable, while there was instability in the months before the 2015 one

      Good point, but could be a little clearer. Maybe add "immediately before"?

    4. Moving to a codebase that is about 20 years newer and supported by an active community can do a lot to improve things

      Nice quote! Great to have the clear articulation of the high-level benefit.

    5. the webservice code

      As a less technical reader, I'm feeling a bit lost in a sea of jargon by this point. Possible to define any of these terms -- especially this one -- within the text?

    6. opinion of reliability

      Is it possible to present this in the context of any objective measure of reliability? I.e., can you say something like "uptime increased by x% from 2015 to 2016. Survey responses indicated that developers noticed, and that they valued uptime above other factors."

    1. feel like

      I think "believe" would be stronger. If you accept my suggestion above of changing the byline to just IJethroBT, how about including a direct quote from Pax here?

    2. MusikAnimal then quickly and single-handedly developed

      I think one of the great outcomes here is that you showed the value of establishing consensus around a bit of functionality, independent of the assessment of how to implement it. Once consensus was established, a creative technical approach emerged. Maybe add a paragraph to describe this more explicitly?

    3. On Phabricator

      Possible to make this point without naming a specific tool that many readers will not know about? (e.g., "in a discussion on Wikimedia's bug tracking site" or similar)

    4. proposal

      Seems to me that some users also emphasized the value, in certain circumstances, of permitting users to edit one another's pages -- seems worth a mention, no?

    5. and Funcrunch

      The article consistently places IJethroBT in the first person, and Pax in the third person. I'd suggest sticking with that, and giving IJethorBT the exclusive byline. If that's undesirable, it should be rewritten a bit to make this contrast less confusing to the reader.

    6. the defacement of their user page felt particularly violating, akin to spray-painting hate speech on their front door

      This is good stuff, but I'd suggest moving it further down in the piece -- as I understand it, the feature is aimed at reducing all manner of harassment, not just that related to transgender issues. Early on, it should talk about the kind of harassment that can/does occur on user pages; later on, bring Pax's personal angle into it.

    7. all base user pages (but not subpages)

      This article will be more accessible if it answers clearly "what is a user page" (as distinct from user talk, and from subpages) before getting into what is protected how.

    8. many

      Delete -- the more straightforward the better. If we can quantify how frequent an issue it is, we should do so; but adjectives like this will make the piece feel less neutral to our more skeptical readers.

    9. as an edit filter

      This part is IMO too technical for the lead sentence. It's worthwhile information, but many affected readers will not know or care what is an edit filter vs. a user permission etc. Put this further down in the article, to make the lead stronger.

  8. Nov 2016
    1. with captions based on contributions from others

      Should drop this; if there are significant contributions from others, let's indicate them in the captions themselves. "Others" does not mean anything to the reader, and doesn't really give credit to an individual in a meaningful way.

    2. massive

      Important to answer "what is the event" in the first couple of sentences. Let's drop "massive" in favor of some numbers that indicate the scale and let the readers conclude for themselves how big it is.

      The lead could be 2 or even 3x as long; let's be sure it offers sufficient context to readers who might be encountering WLM for the first time.

  9. frodehegland.com frodehegland.com
    1. literature review

      Is the external value of a thesis generally considered to be the lit review? As a non-academic, I find that idea depressing. I would hope there is more value than that in a significant number of theses.

    2. honest

      Honesty is of course a very important concept, but it feels very out of place in this bullet point. If it's a major focus, I'd use a separate bullet point to explain your thinking more fully; otherwise, delete.

    3. The tools of this discourse remains rooted in the ancient substrate of paper however and our interactions with the written word is constrained by the inflexibility of media centuries old, hardly taking advantages of the unique characteristics of connected, richly interactive digital text.

      This paragraph is key! Excellent stuff. I would suggest rewriting this one a few times...really get this one right. Excellent core, but there are layers of perfection ahead of you.

    4. a last

      It's either superlative or it's not. Should be either "the last" or else "a significant" or something like that.

      And the Wikipedian in me would argue, it should be, it's not the last bastion. It's one of several. Academia has a responsibility, journalism and government and civil society do too, and many of us try to play this role outside traditional institutions. Academia is not unique in this respect. (But maybe academics would like being told it is, I don't know.)

    5. without any

      I would replace this with "with insufficient." It's a very strong proposition that a lot of people have no concern at all; but it's a very defensible position that huge numbers of people in huge numbers of transactions exhibit insufficient concern.

  10. Oct 2016
    1. But it is clear that GA Cups do not lead to "drive-by" passes

      Ah, I see. Yes, this point is worth making. I think you should reduce the detail in the preceding text, though. You're not making a strong argument here, so the data and half-arguments may come across as noise.

    2. seemingly occurred during natural backlog reductions

      You have two overlapping ideas in this paragraph: two things can coincide/correlate, but leave open a question of causation. If your point is about causation, you can't use that to justify denying that correlation exists. Two paragraphs, one on each?

    3. But what about the earlier declines

      Earlier in the piece (not exactly sure where), I'd like to have read something explicitly stating the important differences between the backlog drives and the GA Cup. In what respects are the GA Cup more substantial? Perhaps in the same paragraph summarizing Figureskatingfan's message?

    4. receiving nominations for deletion

      Even as an experienced Wikipedian, I have a hard time grasping how this supports the claim before the statement. Can you draw out the connection a bit more -- or else remove the evidence? I don't think it's necessary to your point.

    5. A multi-round competition modeled

      Since the piece is so focused on how the GA Cup is impacting the backlog overall, can you say a few words in this paragraph to assert that reducing the backlog was part of the original point of the GA Cup? (assuming that's true, of course)

    6. but the number of reviews being done by a given reviewer will balloon, causing them to burn out by the end of the competition

      This is a bit confusing -- I thought this paragraph was going to be looking at GA outside the context of the competition. I think I see the point you're getting at, but it should be more explicit.

    7. Indeed, there is a larger problem that plagues all backlog elimination efforts, not just the GA Cup: editor fatigue

      This article just got much more interesting! But, you should tease this point in the first couple sentences (perhaps the headline/subhead) or you may lose readers.

    8. The GA Cup is qualitatively the most successful review backlog reduction initiative to date

      This claim is a little too bold, given the evidence presented. Were other language Wikipedias considered, or other backlogs (like A or FA)? If this is limited to GA on enwp, state that more explicitly. Or if there is somebody familiar who could supply a quote, that's another way to get at it.

    9. Reviewers are divided into several pools, and those who have the most points in their pool (and at least one "wild-card", a top reviewer that did not win a pool) advance to the next round.

      I don't entirely follow this -- possible to explain more clearly? Use 2 or 3 sentences instead of 1? (Or else, don't get into this much detail -- maybe not necessary)