VirtualTam's bookmarks

41. Diátaxis - A systematic approach to technical documentation authoring 2024-01-07

    tags: community, documentation, guide, open-source, writing

    [ permalink ]

    • evildmp/diataxis-documentation-framework
    • Continuation of Divio's Documentation System
    • BrightTALK - Introducing the Diátaxis Approach to Technical Documentation
    • PyCON AU 2017 - What nobody tells you about documentation
    • What is Diátaxis and should you be using it with your documentation?

    Examples:

    • Django Documentation - How the documentation is organized
    • Gatsby - A React-based open source framework for creating websites

    Critiques:

    • My Problem With the Four-Document Model
42. Debian Package Repository - Instructions to connect to a third-party repository (with Ansible) 2024-01-06

    tags: configuration-management/ansible, cryptography/pgp, cryptography/pgp/gnupg, linux/debian, linux/ubuntu, packaging

    [ permalink ]

    • apt_key deprecated in Debian/Ubuntu - how to fix in Ansible
    • ansible.builtin.deb822_repository - Add and remove deb822 formatted repositories
    • ansible/ansible#78063 - ansible.builtin.apt_key adds keys to a deprecated location
    • Example usages of the new deb822_repository Ansible module
    • Ubuntu [Spec] APT deb822 sources by default
43. Elite: "The game that couldn't be written" 2023-12-20

    tags: embedded, game, graphics/3d, nintendo/nes

    [ permalink ]

    • Elite [disc] on the BBC Micro Games Archive
    • Fully documented source code for Elite on the BBC Micro and NES
    • Ian Bell's Elite Home Page
44. trace2receiver - OTEL collector receiver component for Git Trace2 telemetry data 2023-11-03

    tags: observability/opentelemetry, observability/tracing, programming/go, source-code-management/git

    [ permalink ]

    • Git Trace2 API
    • git-ecosystem/sample-trace2-otel-collector
45. Confusing Git Terminology 2023-11-03

    tags: command-line, source-code-management/git

    [ permalink ]
46. licensee - A Ruby Gem to detect under what license a project is distributed 2023-10-08

    tags: license, open-source, programming/ruby, source-code-management/github

    [ permalink ]

    • Open source license usage on GitHub.com
    • Easily discover and navigate to multiple licenses in repositories
    • Declaring multiple licenses in a GitHub project
47. When Open Becomes Opaque: The Changing Face of Open-Source Hardware Companies 2023-07-17

    tags: 3d-printer, community, diy, electronics, embedded, open-hardware, patent

    [ permalink ]

    • More on the Shifting State of Open Source Hardware
    • Stratasys Lawsuit, Patents and More: An Interview with MakerBot’s Bre Pettis
    • Prusa - The state of open-source in 3D printing in 2023
48. Forgejo | Beyond coding. We forge. 2023-06-24

    tags: agile/kanban, programming/go, self-hosting, source-code-management/git

    [ permalink ]

    • forgejo.org
    • Codeberg launches Forgejo
    • Forgejo User Guide
    • Forgejo Admin Guide
    • Open issues labeled 's/Gitea/Forgejo'
    • Forgejo makes a full break from Gitea
    • forgejo/meta#86 - [Discussion] Relicensing Forgejo as copyleft
    • forgejo/sustainability
49. How to manage CVE security vulnerabilities with Grafana, MergeStat, and OSV-Scanner 2023-06-12

    tags: database, observability/grafana, security

    [ permalink ]

    • google/osv-scanner
    • OSV - A distributed vulnerability database for Open Source
    • mergestat/mergestat
50. Write Inclusive Documentation | Google Developers 2023-06-12

    tags: diversity, documentation, people, programming/go, society, text

    [ permalink ]

    • Apple Style Guide - Editorial guidelines for Apple
    • Atlassian Design System - Inclusive Language
    • Microsoft Learn - Bias-free communication
    • Red Hat - Making open source more inclusive by eradicating problematic language
    • get-woke/woke - Detect non-inclusive language in your source code
51. Git - git-for-each-ref Documentation 2023-02-25

    tags: command-line, source-code-management/git

    [ permalink ]

    • https://github.com/git/git/blob/c25fba986bfc737d775430d290b93136d390e067/t/t6300-for-each-ref.sh#L79-L216
    • https://stackoverflow.com/questions/21256861/what-are-valid-fields-for-the-format-option-of-git-for-each-ref
52. Cube Cola - We are wildcrafting our own cola from an open source recipe reverse-engineered from the original Coke 2023-02-20

    tags: cola, drink, recipe, soda

    [ permalink ]

    • https://cube-cola.org/index.php?route=information/information&information_id=10
    • https://www.reddit.com/r/linux/comments/8j50ja/this_norwegian_soda_t%C3%B8yen_cola_is_open_source/
    • https://en.wikipedia.org/wiki/OpenCola_(drink)
53. (A few) Ops Lessons We All Learn The Hard Way 2023-02-18

    tags: cloud-computing, network/dns, programming/shell, sysadmin

    [ permalink ]

    28. Blocking TCP port 53 traffic leads to very strange failures. Don't.
    29. The source you're looking at is not the code running in production.
    30. "Prod" is just another name for "staging".

54. shell guide | Style guides for Google-originated open-source projects 2023-02-18

    tags: programming/shell, static-analysis/lint

    [ permalink ]
55. git - Explain which gitignore rule is ignoring my file 2022-12-27

    tags: source-code-management/git

    [ permalink ]

    • https://git-scm.com/docs/git-check-ignore
56. Analyzing 1.1 Billion NYC Taxi and Uber Trips, with a Vengeance 2022-09-22

    tags: database/clickhouse, database/postgresql, dataset, programming/apache-parquet, programming/r

    [ permalink ]

    An open-source exploration of the city's neighborhoods, nightlife, airport traffic, and more, through the lens of publicly available taxi and Uber data

    • https://github.com/toddwschneider/nyc-taxi-data
    • https://tech.marksblogg.com/billion-nyc-taxi-rides-redshift.html
    • https://tech.marksblogg.com/all-billion-nyc-taxi-rides-redshift.html
    • https://tech.marksblogg.com/billion-taxi-rides-doublecloud-clickhouse.html
57. Signing Git Commits with Your SSH Key 2022-09-15

    tags: network/ssh, security, source-code-management/git

    [ permalink ]
58. Github API | Deprecation Notice: GraphQL for Packages 2022-08-27

    tags: programming/api/graphql, programming/api/rest, source-code-management/github

    [ permalink ]

    • https://twitter.com/simonw/status/1562502194150068230
    • https://twitter.com/dam/status/1562807312166764544
59. How to use GitHub API to get a repository's dependents information in GitHub? 2022-08-27

    tags: programming/api/graphql, programming/api/rest, source-code-management/github

    [ permalink ]

    • https://til.simonwillison.net/github/dependencies-graphql-api
    • https://github.com/dogsheep/github-to-sqlite/issues/34
    • https://github.com/github-tooling/ghtopdep
    • https://github.com/hacker-DOM/github-by-stars
60. GitHub CLI | Take GitHub to the command line 2022-08-03

    tags: command-line, programming/go, source-code-management/git, source-code-management/github

    [ permalink ]

    • https://cli.github.com/manual/gh
    • https://cli.github.com/manual/
    • https://github.com/cli/cli