Conversation

Notices

1. Embed this notice
   Anil Dash (anildash@me.dm)'s status on Tuesday, 12-Mar-2024 10:02:51 JST Anil Dash

   • Waldo Jaquith

   Just updated: Make Better Documents, a quick guide I wrote up with some tips on how to make your professional documents more effective. It covers many of the most common errors I’ve seen (or that I’ve _done_) and some suggestions on how to address them. I hope it’s helpful, and feel free to share your tips on what else could be included. https://anildash.com/2024/03/10/make-better-documents/ (Thanks to @waldoj for pointing out one bonus item I’d missed!)

   • Embed this notice
     Anil Dash (anildash@me.dm)'s status on Tuesday, 12-Mar-2024 10:34:32 JST Anil Dash

     in reply to

     • Pomax

     @TheRealPomax @anildash I think they’re pigments but yeah it looked like wax to me

   • Embed this notice
     Pomax (therealpomax@mastodon.social)'s status on Tuesday, 12-Mar-2024 10:34:33 JST Pomax

     in reply to

     @anildash quasi-relatedly... is that sparkly seal wax?

   • Embed this notice
     Saara (designergeeking@mstdn.social)'s status on Tuesday, 12-Mar-2024 11:16:14 JST Saara

     in reply to

     @anildash I'd love to see accessibility also addressed in making better docs. Better accessibility often also means better communication. Take images for example: An accessible image is tagged with alternative text to describe it for people who are blind or have low vision. If you can't come up with good alt text for an image, that's probably a good sign it's not communicating anything of value and can be omitted completely.

   • Embed this notice
     Anil Dash (anildash@me.dm)'s status on Thursday, 14-Mar-2024 02:57:12 JST Anil Dash

     in reply to

     • Joseph Reagle

     @reagle ah thanks, i'll see if i can add them. you can use query-based fragments too https://www.anildash.com/2024/03/10/make-better-documents/#:~:text=It%27s%20not%20a%20murder%20mystery

   • Embed this notice
     Joseph Reagle (reagle@ohai.social)'s status on Thursday, 14-Mar-2024 02:57:14 JST Joseph Reagle

     in reply to

     @anildash I wanted to refer someone to your "It's not a murder mystery" but your headings to have fragment identifiers.

   • Embed this notice
     Anil Dash (anildash@me.dm)'s status on Thursday, 14-Mar-2024 06:53:09 JST Anil Dash

     in reply to

     • Joseph Reagle

     @reagle @anildash yep, it’s a standard now

   • Embed this notice
     Joseph Reagle (reagle@ohai.social)'s status on Thursday, 14-Mar-2024 06:53:11 JST Joseph Reagle

     in reply to

     @anildash oh, I thought they were a Google/Chrome exclusive, but they apparently work on Safari on my ipad. I’ll have to see if those are standard and widely supported now.