Every now and then, documentation in source code requires an ASCII table. Sometimes table cells are spanning multiple rows or/and column.
TL;DR: The tools I tried did not support that, so manual labour is still needed.
Archive for the ‘Documentation Development’ Category
Generating ASCII-tables with spanning cells: manual labour still needed
Posted by jpluimers on 2026/05/28
Posted in ASCII, ASCII art / AsciiArt, Development, Documentation Development, Encoding, Excel, Fun, HTML, Office, Power User, Software Development, Web Development | Tagged: 2 | Leave a Comment »
RFC2606: Reserved Top Level DNS Names (RFC); draft-ellermann-idnabis-test-tlds-04: Reserved Top Level DNS Names (Internet-Draft, 2008)
Posted by jpluimers on 2022/01/20
Note
Though there are .example.edu and .example.info, though used in documentation and registered by IANA, have a status is different from the official Reserved Top Level DNS Names:
This is not exactly the same situation as for say ".example.org", where IANA is the registrant *and* registrar.
Wikipedia links:
-
- .example – Wikipedia
- .invalid – Wikipedia
- .local – Wikipedia
- .localhost – Wikipedia
- .test – Wikipedia
- localhost – Wikipedia
- Email address: Reserved domains – Wikipedia
Of note for e-mail are
example,invalid,example.com,example.net, andexample.org. - Example.com – Wikipedia (which puts
example.eduon the same level asexample.com,example.netandexample.org; this is not true, despite the domain being registered by the IANA, the IANA is not the registrar of the.edudomain) - Top-level domain: Reserved domains – Wikipedia
Reserved by RFC 2606 and explained further in RFC 6761:
- .test
- .example
- .invalid
- .localhost
Reserved by RFC 6762: .local
Reserved by RFC 7686: .onion
Reservation proposal by Internet-Draft draft-wkumari-dnsop-internal-00: .internal
Share this:
Posted in Development, DNS, Documentation Development, Internet, Power User, Software Development, Testing | Leave a Comment »
Drawing with nice handwriting
Posted by jpluimers on 2021/11/10
Did you also wonder about the nice handwriting in the diagrams of yesterday’s post @adamsand0r drew up a few sketches of design decisions needed to be taken when building a #gitops-based CD pipeline « The Wiert Corner – irregular stream of stuff?
I did too.
They are from [Archive.is] Excalidraw | Hand-drawn look & feel • Collaborative • Secure, with source code at [Archive.is] GitHub – excalidraw/excalidraw: Virtual whiteboard for sketching hand-drawn like diagrams.
Via:
- [Archive.is] Ádám Sándor on Twitter: “https://t.co/AVhZ5AbMVM ;)… “
- [Archive.is] Jeroen Pluimers on Twitter: “Hmm… domain does not exist. Oh wait: excalidraw.com does. I’m always confused by top-level-domains too (:…”
–jeroen
Share this:
Posted in Development, Documentation Development, LifeHacker, Power User, Software Development | Leave a Comment »
Geek And Poke: The New Developer
Posted by jpluimers on 2019/07/03
Old, but still so funny because it is so true: [WayBack] Geek And Poke: The New Developer
–jeroen
via:
- [WayBack] Haha :D – Linux For Geeks – Google+
- [WayBack] Haha :D – DoorToDoorGeek “Stephen McLaughlin” – Google+
Share this:
Posted in Comics, Development, Documentation Development, Fun, Quotes, Software Development | Leave a Comment »
Keep a Changelog
Posted by jpluimers on 2019/03/20
Lot’s of tips (and translations!) on how to Keep a Changelog [WayBack].
There are lots of useful tips, ranging from content (how to write, what to include) to technicalities (order of entries, unreleased, version numbering, date format) that might seem unimportant but in practice makes using the changelog.
The really cool thing: the site has a changelog of itself showing the best practices.
via:
- [WayBack] Changelog information is not discoverable (not in README, no longer in docs) · Issue #3420 · certbot/certbot
- which now resulted in a proper change log for the LetsEncrypt certbot: [Archive.is] certbot/CHANGELOG.md at master · certbot/certbot
–jeroen
Share this:
Posted in Development, Documentation Development, Encryption, Let's Encrypt (letsencrypt/certbot), Security, Software Development | Leave a Comment »
The Wiert Corner - irregular stream of stuff 