47 Matching Annotations
  1. Mar 2021
    1. Whenever I get a new cookbook, I go through it and bookmark recipes that are either worth considering, or that go on a list to definitely try. Usually the maybes outnumber the definites. In this case, I've bookmarked a large number of recipes that I DEFINITELY will make.
    1. Solution The goal should be to use Markdown on git as the source of the documentation by default. This will make version control possible and facilitate collaboration. To achieve this, the first step should be to export all the InDesign files to Markdown, going through HTML. This page explains how to export InDesign to HTML Once the HTML files have been generated, converting them to markdown requires Pandoc. Help the client install Pandoc following this guide There is also a web version of Pandoc Some markdown editors like Atom export HTML into markdown Assuming the HTML file that needs to be converted is named file.html and the Markdown file the client needs to generate should be called file.md, the command to convert HTML to markdown is this: pandoc -o file.md file.html Once all the HTML files have been converted to markdown, the client can start updating their files directly in the git repository. Markdown files can then be imported into InDesign going through HTML whenever the client feels they can consolidate one version into a PDF or print. To export Markdown into HTML Pandoc can be used again, but also editors like Atom or ReText export markdown into HTML. This time the command in pandoc will be: pandoc -o file.html file.md ( assuming the Markdown file that needs to be converted is named file.md and the HTML file the client needs to generate should be called file.html). A howto for importing HTML to InDesign Instead of the Python script included in this article to delete new lines in the HTML file (which doesn’t seem to work), we can send the client this script in bash. The script can be launched on a Linux machine (it should also work in a Mac terminal). Instructions for the client: Download the attached file to the folder where you have saved your HTML files. You can open the file with a text editor to check that all is ok. You can also find the script here: https://github.com/AccessNow/helpline_documentation_resources/blob/master/scripts/sed-clean-HTML.sh allow the script to be executed, by running this command: chmod 777 sed-clean-HTML.sh run this command on all your files: ./sed-clean-HTML.sh filename.html
    1. Marked has a basic AppleScript dictionary, and allows you to get the document filename from multiple windows, as well as open files from scripts. This allows some workflow integration if you know a little bit of AppleScript. You can have any application which can trigger an AppleScript open a document in Marked, or have it retrieve a document from Marked for editing or other actions.
  2. Feb 2021
    1. Additional testing of pipeline portability is currently being conducted as a part of the Global Alliance for Genomics and Health (GA4GH) workflow portability challenge

      For more on how this went and an update on where the platform has developed to in Feb 2021 can be viewed in this video from CWLcon2021 https://youtu.be/vV4mmH5eN58

  3. Jan 2021
  4. Dec 2020
    1. Better community building: At the moment, MDN content edits are published instantly, and then reverted if they are not suitable. This is really bad for community relations. With a PR model, we can review edits and provide feedback, actually having conversations with contributors, building relationships with them, and helping them learn.
    2. Better contribution workflow: We will be using GitHub’s contribution tools and features, essentially moving MDN from a Wiki model to a pull request (PR) model. This is so much better for contribution, allowing for intelligent linting, mass edits, and inclusion of MDN docs in whatever workflows you want to add it to (you can edit MDN source files directly in your favorite code editor).
  5. Nov 2020
    1. I'd like to go with an RFC-based governance model (similar to Rust, Ember or Swift) that looks something like this: new features go through a public RFC that describes the motivation for the change, a detailed implementation description, a description on how to document or teach the change (for kpm, that would roughly be focused around how it affected the usual workflows), any drawbacks or alternatives, and any open questions that should be addressed before merging. the change is discussed until all of the relevant arguments have been debated and the arguments are starting to become repetitive (they "reach a steady state") the RFC goes into "final comment period", allowing people who weren't paying close attention to every proposal to have a chance to weigh in with new arguments. assuming no new arguments are presented, the RFC is merged by consensus of the core team and the feature is implemented. All changes, regardless of their source, go through this process, giving active community members who aren't on the core team an opportunity to participate directly in the future direction of the project. (both because of proposals they submit and ones from the core team that they contribute to)
  6. Sep 2020
    1. separate the workflow description from its execution.

      Separating a workflow description from its execution is an important aspect of reproducibility.

    1. And because it's real CSS, rather than some camelCased quotes-everywhere impostor, we can take advantage of the 'tweak in devtools, paste back into our source code' workflow, which I personally couldn't live without.
    1. Many changes, including bug fixes and documentation improvements can be implemented and reviewed via the normal GitHub pull request workflow. Some changes though are "substantial", and we ask that these be put through a bit of a design process and produce a consensus among the Yarn core team. The "RFC" (request for comments) process is intended to provide a consistent and controlled path for new features to enter the project.
  7. Jul 2020
  8. Jun 2020
  9. May 2020
  10. Dec 2019
    1. Archiving and downloading annotations Annotation viewing and export, from Hypothesis Labs Link: https://jonudell.info/h/facet Screencast: https://jonudell.net/h/facet.mp4 Description:  View annotations by user, group, URL, or tag. Export results to HTML, CSV, text, or Markdown.

      Did anyone tried to use this to feed mind/concept-mapping tools like Tinderbox or Cmap?

    1. Is there any way to use this to catch hypothesis annotations into a mind/concept map app? Like Tinderbox or cmaptools?

    1. However, it did require us to think differently about the creation, maintenance, and sustainment of our components moving forward — an integrative process we call "storybook-driven development."
  11. Nov 2019
  12. Jan 2019
    1. These protocols, formal structures, plans, procedures, and schemes can be con-ceived of asmechanismsin the sense that they (1) are objectified in some way(explicitly stated, represented in material form), and (2) are deterministic or at leastgive reasonably predictable results if applied properly. And they aremechanisms ofinteractionin the sense that they reduce the complexity of articulating cooperativework.

      People apply "mechanisms of interaction" to reduce the complexity of the articulation work.

      Schmidt and Bannon use these examples:

      • Formal and informal organizational structures • Planning and scheduling • Standard operating procedures (see Suchman's work on situated action) • Indexes and classifications for organizational and retrieval (see Bowker and Star on boundary objects/infrastructures)

    2. Therefore, instead of pursuing the elusive aim of devising organizational modelsthat are not limited abstractions and thus in principle brittle when confronted withthe inexhaustible multiplicity of reality, organizational models in CSCW applica-tions should be conceived of asresourcesfor competent and responsible workers.

      Schmidt and Bannon posit that organizational models in CSCW should be flexible enough to support new interpretations/evaluations of the model (contingent on circumstances), as well as capture decisions to "adapt, circumvent, execute, modify, etc. the underlying model".

  13. Dec 2018
    1. Exceptions are normal in work processes.

      More specific reference to workflow as a prime CSCW concern. Exceptions, edge cases, and fluid roles need to be accommodated by technology.

  14. Nov 2018
    1. Re-open libraries for exploration I use in-ns to jump into library namespaces and re-define their vars. I insert bits of println statements to help understand how data flows through a library. These monkey-patches only exist in the running REPL. I usually put them inside a comment form. On a REPL restart, the library is back at its pristine state. In this example below, I re-open clj-http.headers to add tracing before the header transformation logic: [source] ;; set us up for re-opening libraries (require 'clj-http.headers) (in-ns 'clj-http.headers) (defn- header-map-request [req] (let [req-headers (:headers req)] (if req-headers (do (println "HEADERS: " req-headers) ;; <-- this is my added print (-> req (assoc :headers (into (header-map) req-headers) :use-header-maps-in-response? true))) req))) ;; Go back to to the user namespace to test the change (in-ns 'user) (require '[clj-http.client :as http]) (http/get "http://www.example.com") ;; This is printed in the REPL: ;; HEADERS: {accept-encoding gzip, deflate} An astute observer will notice this workflow is no different from the regular clojure workflow. Clojure gets out of your way and allows you to shape & experiment in the code in the REPL. You can use this technique to explore clojure.core too!

      explore library code in the repl in-ns and the redefinition

  15. Sep 2018
    1. We'll first look at modelling the problem space - what is common to, and what differs between, thedifferent product variants. Then we'll consider one possible approach for realising product variants in the solutionspace using C++ as an example. Finally we'll look at how Application Engineering is performed by using theproblem and solution space models to create a product variant.
    2. In reality, this linear flow is rarely found in practice.Product Lines usually evolve continuously, even after the first product variants have been defined and deliveredto customers.
  16. Jul 2018
    1. Data becomes dark because no one is paying attention. There is little professional reward structure for scientists to preserve and disseminate raw data. Scientists are rewarded for creating high-density versions of their data in statistics, tables, and graphs in scholarly journals and at conferences. These publications in some ways are the sole end product of scientific inquiry. These products, while valuable, may not be as useful as some authors hope.

      Reward system in place is not rewarding the preservation of dark data.

  17. Jun 2018
    1. Traders continue to monitor their open positions and look for any more opportunities.
    2. If everything is working properly, traders start scanning the markets for potential trading opportunities.
    3. After reading about events and making note of what the analysts are saying, traders head to their workstations, turn on their computers and monitors and open up their analysis and trading platforms.
    4. Traders will also review economic calendars to find out which market-moving financial reports – such as the weekly petroleum status report – are due that day.
    5. This involves reading stories from various newspapers and financial websites, as well as listening to updates from financial news networks, such as CNBC and Bloomberg.
  18. May 2018
  19. Oct 2017
  20. Sep 2017
  21. Feb 2017
  22. Feb 2016
    1. Hi! I'm interested in translate the handbook into spanish, but I have a couple of questions: 1) Is someone already doing this? and 2) is there any methodology or guidelines of the flow of information among translators?