142 Matching Annotations
  1. Sep 2018
    1. The epub:type attribute [ContentDocs32] is REQUIRED

      Discerning the available values of epub:type is a tangle... The referenced epub:type related section in the ContentDocs32 document references the Vocabulary Association paragraph which in turn references the Vocabulary Association Mechanisms section within this current document. From that section the default vocabulary can/may be found, but there is no reference there (or in any of these other sections) to the available epub:type values nor to their "meaning"/value to the author or implementer.

      However, just below this in the example (and above in relation to pagebreak there is a link directly to the defining defaults in the EPUB-SSV.

      It would be helpful for authors and implementers to know first about the SSV list, and then about the ability to extend the vocabulary.

    2. The toc nav element

      This makes it sound like there is an HTML element with a tag name of <toc nav> rather than <nav epub:type="toc"> (which seems to be what's intended).

      The landmarks example farther down is clearer--though the wording there of "the landmark nav element" is equally confusing.

      There remains only a nav element, but of varying types.

    3. In the context of this specification, the default display style of list items within nav elements MUST be equivalent to the list-style: none property [CSSSnapshot].

      This line is confusing because the actor (author or reading system) is unclear. The following two lines are much clearer on what actor is being restricted by this specification.

      This line feels specific to the Reading System requirements. Consequently, perhaps it's best to integrate it into the sentence just following.

    4. If an a or span element contains instances of HTML embedded content that do not provide intrinsic text alternatives, the element MUST also include a title attribute with an alternate text rendering of the link label.

      This requirement is clearer than the one just previous and also seems to obviate the earlier one.

      However, this one is confusing limiting the textual expression to just the title attribute, and also being vague of which element is associated to the MUST--is it this surrounding a or span? or the contained "embedded content" element?

  2. Dec 2017
    1. 6. It should be possible to further qualify a reference to a "sublocation" within an object (which would have meaning only to the server that houses it). This is needed, for example, for hypertext-type links. Such a sublocation might be the 25th paragraph of a text, for a hypertext-type pointer.
  3. Apr 2016
  4. Jan 2016
    1. ipfs cat /ipfs/QmPXME1oRtoT627YKaDPDQ3PwA8tdP9rWuAAweLzqSwAWT/readme

      This line didn't work for me (on Windows).

      However, after starting the daemon, I was able to do the following:

      ipfs cat QmPXME1oRtoT627YKaDPDQ3PwA8tdP9rWuAAweLzqSwAWT/readme
      

      Not sure what's up.

  5. Dec 2015
  6. Nov 2015
    1. Companies need to have realistic expectations of the work-life balance of open source maintainers.

      When you hire an open source developer, you hire someone who works all the time--not just 8-5, not just at a desk, not just on that one pet project that management's currently excited about. They work on that, they work on the related libraries, they work on projects that use those libraries, they work on the next great version of the libraries the company will need in two more years.

      Plan for your own future by letting your developers explore it for you. They already are...even before you've hired them.

    2. effectively contribute and participate in upstream projects

      If anything is missing with regards to open source within companies (of all sizes), it's this situation.

      Teaching "companies" (or rather the entire management stack/chain) how to "effectively contribute and participate in upstream projects" could change the game for those companies, the projects they interface with, and certainly for the developers (inside and outside of the companies).

    3. They should be treated like adults though and allowed to spend what they see as an appropriate amount of time working on the project versus other projects for the company. Trying to quanitfy/limit the amount of time leads to conflict and strife and unhappy management and employees. It doesn't work and it's not a long term, maintainable solution.

      In the end, it's a quest of trust. Hire people who work on the open source projects your company depends on. Then, let them keep doing it--for pay...at last!--and expect them to continue to balance the worlds of open source and business...as they likely already were, but now with the needle tilted slightly (or more, one would hope) in favor of working on open source code.

      It's like picking flowers. If you pick them and bring them inside, they die. Plant them in some fertile ground, however, and let them keep doing their thing. (OK, that was a bit strained...but hopefully you see my point ^_^).

    4. Some projects work to actively alienate corporations trying to contribute because of ideology. This is not the path that will lead us to sustainable open source software development and companies that can contribute responsibly.

      :+1:

      /me pats IBM on the back one more time. :)

      There are (a very few) companies that balance these worlds of community and commerce well.

      If you know of another, please reply!

    5. The company refuses to expand the core development team with non-employees

      From what I've seen these projects are often licensed under the AGPL and essentially amount to "loss leader source." Community === "add on builders" and "consumers" in the minds of the product team not future "land owners."

      Be sure the project is community lead (or in transition that way at least!) before you sign that CLA...or even bother with that patch.

    1. Definition SLE System of Linear Equations

      $$\begin{align*} a_{11}x_1+a_{12}x_2+a_{13}x_3+\dots+a_{1n}x_n&=b_1\\ a_{21}x_1+a_{22}x_2+a_{23}x_3+\dots+a_{2n}x_n&=b_2\\ a_{31}x_1+a_{32}x_2+a_{33}x_3+\dots+a_{3n}x_n&=b_3\\ &\vdots\\ a_{m1}x_1+a_{m2}x_2+a_{m3}x_3+\dots+a_{mn}x_n&=b_m \end{align*}$$

    1. The URI generic syntax for authority also includes a deprecated userinfo subcomponent ([RFC3986], Section 3.2.1) for including user authentication information in the URI. Some implementations make use of the userinfo component for internal configuration of authentication information, such as within command invocation options, configuration files, or bookmark lists, even though such usage might expose a user identifier or password. A sender MUST NOT generate the userinfo subcomponent (and its "@" delimiter) when an "http" URI reference is generated within a message as a request target or header field value. Before making use of an "http" URI reference received from an untrusted source, a recipient SHOULD parse for userinfo and treat its presence as an error; it is likely being used to obscure the authority for the sake of phishing attacks.

      You know...it didn't have to be this way...

      RFC3986 Section 3.2.1 states (emphasis added):

      The userinfo subcomponent may consist of a user name and, optionally, scheme-specific information about how to gain authorization to access the resource.

      Additionally, it clearly states that use of the : is deprecated.

      Use of the format "user:password" in the userinfo field is deprecated. Applications should not render as clear text any data after the first colon (":") character found within a userinfo subcomponent unless the data after the colon is the empty string (indicating no password).

      Further removal of the use of the userinfo section in HTTP URIs by this RFC was unnecessary...and now just complicates future use of this space.

      Were it not for this paragraph in RFC7230, userinfo.me could have been a simple thing...

      Quoting the sad bit one more time...

      A sender MUST NOT generate the userinfo subcomponent (and its "@" delimiter) when an "http" URI reference is generated within a message as a request target or header field value.

      Time for a new RFC which updates this one and fixes this error.

    1. If you have a copy of the ReSpec repository handy, you may see that there is also a respec2html.js tool under tools/. Feel free to try using it instead of the above process, but please note that it is not used much currently and may behave in a somewhat experimental manner (experiences with it vary — but it's worth a shot if you're looking for a way to generate ReSpec output from the command line).

      Respec (sadly) doesn't quite have a command line tool...at least not one comparable to a browser's output.

      Maybe PhantomJS (which Respec uses for tests) would do a better job?

    1. It is up to the domain model and server to determine the appropriate predicate to indicate the resource’s order within a page (or globally), and up to the client receiving this representation to use that order in whatever way is appropriate to meet its needs, for example to sort the data prior to presentation on a user interface.
  7. Oct 2015
    1. a web so conceptually consistent, socially relevant and technically expandable

      We've done relatively well with the first two. "Technically expandable" is the one in danger.

      If we continue to build "social networks" as singular dead end cul-de-sacs, we leave no exit available to those who follow.

      The Web we want is expandable beyond the reaches of what we currently know, the economies we operate within, and the future we can currently conceive.

  8. Sep 2015
    1. Schedule

      Let me know if I've missed anything! Feel free to link to photos, videos, send in editorial corrections, or link to blog posts you cite in your talk.

      The page will continue to change throughout the weekend, so you're input and help are very welcome!

  9. Aug 2015
    1. An external tool can ask for an xAPI callback URL, and then POST back an interaction activity to Canvas. This will update the activity time for the user in Canvas, and add a page view for that tool. Page views will show up in the course analytics section as activity.
    1. Traditionally, a learner's data stays within the LMS or the organization running the LMS. Unlike an LMS, the LRS and the xAPI enable the sharing of data between LRSs and other xAPI-enabled tools. This means a learner's data can follow them wherever they go, from school to school and job to job.
    1. compensating for it by also doing good.

      "Good" isn't something you can buy like carbon credits. It's something that's done instead.

      Perhaps the debits and credits economics are at play even here in the terminology used to "understand" doing good.

  10. Jul 2015
    1. We strongly urge you to reconsider your business tactic here and again respect people’s right to choice and control of their online experience by making it easier, more obvious and intuitive for people to maintain the choices they have already made through the upgrade experience.

      Completely agree!

      Now...how do I change my Reader View settings to use something besides Pocket for social bookmarking?

      ...can't seem to find that setting...anywhere.

    1. Let me be very clear: I do not care what the “top highlight” is. In fact, I actively do not want to know what the top highlight is. That kind of information encourages the meme-ification of the web, a world where we care more about pushing one sentence over the “tipping point” into virality than in carrying on a global conversation. It’s American Idol for pull quotes.
    1. The world doesn’t throw a billion dollars at a person because the person wants it or works so hard they feel they deserve it. (The world does not care what you want or deserve.)  The world gives you money in exchange for something it perceives to be of equal or greater value: something that transforms an aspect of the culture, reworks a familiar story or introduces a new one, alters the way people think about the category and make use of it in daily life.
    1. “With artificial intelligence we are summoning the demon. In all those stories where there’s the guy with the pentagram and the holy water, it’s like – yeah, he’s sure he can control the demon. Doesn’t work out.”
  11. Jun 2015
  12. May 2015
  13. Apr 2015
  14. Mar 2015
  15. Feb 2015
    1. leave a group

      Does "leaving" amount to "unsubscribing"? Such that, leaving a group simply means it won't:

      1. show up in your sidebar/stream content
      2. won't send you email for additions in that group
      3. won't be in your list of groups to publish into

      I.e. if I wanted back in, I could find that email with the invite link and re-join (or perhaps there's UI that let's me re-join past groups).

    2. (Again, this is in no way a proposal for how the URLs should be structured.)

      To avoid overvaluing group names by making them scarce, we should include a small uniqueness element like a (very short) UUID.

      Obviously more than one person will want to make a group named "research."

    1. while e-mail dissolves barriers to the exchange of data, we need another solvent to dissolve the barriers to collaborative use of that data. Applied in the right ways, that solvent creates what I like to call the “universal canvas” -- an environment in which data and applications flow freely on the Web.
  16. Jan 2015
  17. Dec 2014
    1. ANNOTATION The information in B is additional to and subsidiary to that in A. Annotation is used by one person to write the equivalent of "margin notes" or other criticism on another's document, for example. Example: The relationship between a newsgroup and its articles. Acyclic.

      Annotation link relationship in HTML 1.0 circa 1993.

  18. Nov 2014
  19. Oct 2014
  20. Sep 2014
    1. While the Atom Protocol specifies the formats of the representations that are exchanged and the actions that can be performed on the IRIs embedded in those representations, it does not constrain the form of the URIs that are used. HTTP [RFC2616] specifies that the URI space of each server is controlled by that server, and this protocol imposes no further constraints on that control.
    1. The cacophony of the crowd erases the past and affirms the present. It started with search and now its accelerated with the now web. I dont know where it leads but I almost want a remember button — like the like or favorite. Something that registers something as a memory — as an salient fact that I for one can draw out of the stream at a later time.
  21. Aug 2014
    1. This user's guide includes introductions to Scalar's features as well as more in-depth material to explore as your get to know the tools. If you're familiar with blogging platforms like WordPress you'll find yourself at home with many of Scalar's editing features, though you can also do things with Scalar that would be next to impossible in a typical blog.

      This is an annotation of a thing on a thing.

  22. Jun 2014
    1. Technology leadership is not defined by patents, which history has repeatedly shown to be small protection indeed against a determined competitor, but rather by the ability of a company to attract and motivate the world’s most talented engineers. We believe that applying the open source philosophy to our patents will strengthen rather than diminish Tesla’s position in this regard.

      "Technology leadership is....defined by...the ability of a company to attract and motivate the world's most talented engineers."

      The key components of this applied "open source philosophy" seem to be about increasing input, visibility, and collective motivation by taking fear out of the interaction equation.

  23. May 2014