Dave Gauer @ratfactor explains why he reads technical books. He expresses very well motivations I share but couldn't articulate, such as books having a single voice and stylistic convention.
Using LLMs to chat with books and documents? That's so 1978.
In the 1970s the HELPSYS facility of Interlisp-10 let you interrogate the 700+ pages Interlisp Reference Manual via an English like syntax. You could run queries on topics and system functions such as TELL ME ABOUT EVAL or TELL ME ABOUT THE 2ND ARG OF CHANGEPROP and HELPSYS would print the relevant information or section of the manual. Here's an example session from the 1978 edition of the manual:
https://www.softwarepreservation.org/projects/LISP/interlisp/Interlisp-Oct_1978.pdf#page=474
Interlisp-10 was the Interlisp implementation for the PDP-10.
just small circles 🕊
and 2 others
boosted
Is anyone using our #WriteFreely Docker image in production? If so, we could use your help with updating our #documentation!
Let me know if you want to contribute, or just feel free to submit a pull request!
https://github.com/writefreely/documentation/blob/main/admin/docker.md
Is anyone using our #WriteFreely Docker image in production? If so, we could use your help with updating our #documentation!
Let me know if you want to contribute, or just feel free to submit a pull request!
https://github.com/writefreely/documentation/blob/main/admin/docker.md
alcinnz
boosted
Doc aliases are such an underrated feature in #Rust docs! Please use it. 🙏
Doc aliases:
https://blog.rust-lang.org/2020/11/19/Rust-1.48/#adding-search-aliases
Example:
https://github.com/smol-rs/async-io/pull/242
cc @imperio
Doc aliases are such an underrated feature in #Rust docs! Please use it. 🙏
Doc aliases:
https://blog.rust-lang.org/2020/11/19/Rust-1.48/#adding-search-aliases
Example:
https://github.com/smol-rs/async-io/pull/242
cc @imperio
Stefano Marinelli
boosted
🚯 No More Markdown 🚯
Well, it's certainly not going away any time soon, but it doesn't have to be the default. While it's easily a majority of the docs formats that I have to use, it's not my favorite.
Perhaps in an ideal world it would be AsciiDoc or LaTeX All The Time, but we don't live in that world, oh well 💋
In the interim, here's someone who wrote about the topic which seems worth sharing. Interesting points, ja?
- Why You Shouldn’t Use “Markdown” for Documentation: https://ericholscher.com/blog/2016/mar/15/dont-use-markdown-for-technical-docs/
🚯 No More Markdown 🚯
Well, it's certainly not going away any time soon, but it doesn't have to be the default. While it's easily a majority of the docs formats that I have to use, it's not my favorite.
Perhaps in an ideal world it would be AsciiDoc or LaTeX All The Time, but we don't live in that world, oh well 💋
In the interim, here's someone who wrote about the topic which seems worth sharing. Interesting points, ja?
- Why You Shouldn’t Use “Markdown” for Documentation: https://ericholscher.com/blog/2016/mar/15/dont-use-markdown-for-technical-docs/
Luc, framage
boosted
BookStack v25.07 is now here with a bundle of improvements:
📝 Markdown Plaintext Input Option
✏️ New Comment/Description Editor
🔧 New WYSIWYG Editor Improvements
📋 Improved Changelog Input
📦 ZIP Import/Export API Endpoints
🏷️ Parent Tag Classes
📱 Multi-Column Layout Refinements
🔐 Better Permission Generation
🌍 Nepali Language & Updates
BookStack v25.07 is now here with a bundle of improvements:
📝 Markdown Plaintext Input Option
✏️ New Comment/Description Editor
🔧 New WYSIWYG Editor Improvements
📋 Improved Changelog Input
📦 ZIP Import/Export API Endpoints
🏷️ Parent Tag Classes
📱 Multi-Column Layout Refinements
🔐 Better Permission Generation
🌍 Nepali Language & Updates
alcinnz
boosted
Your regular reminder to use rustup doc to browse the standard API locally, or cargo doc to browse the documentation of your project and its dependencies.
Save network. Save energy :-].
Luc, framage
boosted
Today BookStack turns 10 years old! 🎂
In this blog-post we celebrate this decade of BookStack with a Q&A, while also diving into the stats & finances of the project:
Today BookStack turns 10 years old! 🎂
In this blog-post we celebrate this decade of BookStack with a Q&A, while also diving into the stats & finances of the project:
Astro Docs is redefining Must-See TV... well, for docs 😅
Tomorrow on Talking and Doc'ing:
- Fixing an Astro Docs SEO issue using Starlight's new routeData.
- Writing docs for a feature that doesn't exist (and that we don't yet even know how we're going to implement) to drive its development!
Subscribe to the @astro YouTube channel and be notified when we go live (Thurs 9ET / 14:00 CET)
just small circles 🕊
boosted
Did you ever have a look at the excellent #documentation of #Purism products?
One of the products of Purism is the #Librem5. The Librem 5 is a #Linux phone that runs the #PureOS operating system.
This phone is built up from the bottom to provide #privacy and software #freedom. No #surveillance by the manufacturer, free and #opensource (#FOSS) is their standard.
I use a Librem 5 as my daily phone.
Did you ever have a look at the excellent #documentation of #Purism products?
One of the products of Purism is the #Librem5. The Librem 5 is a #Linux phone that runs the #PureOS operating system.
This phone is built up from the bottom to provide #privacy and software #freedom. No #surveillance by the manufacturer, free and #opensource (#FOSS) is their standard.
I use a Librem 5 as my daily phone.
Your regular reminder to use rustup doc to browse the standard API locally, or cargo doc to browse the documentation of your project and its dependencies.
Save network. Save energy :-].
Your regular reminder to use rustup doc to browse the standard API locally, or cargo doc to browse the documentation of your project and its dependencies.
Save network. Save energy :-].