mamot.fr is one of the many independent Mastodon servers you can use to participate in the fediverse.
Mamot.fr est un serveur Mastodon francophone, géré par La Quadrature du Net.

Server stats:

3.2K
active users

#documentation

30 posts21 participants0 posts today
Continued thread

@3dprinting I've written the first draft of the assembly guide for the FilaBilly Dehumidifier. It's a Markdown document. I've got a couple dozen photos that I want to insert into the instructions, and I kind of want to make it look better than Markdown. So I'm thinking about word processors. It's been years since I used one. Maybe Apple Pages?

Meanwhile, the rest of the IKEA parts are coming this week. So progress is progressing.

🧵 28/N

Let’s Talk About Data Security – Backups

As collections professionals we are trained to think about security. We constantly make sure that nothing gets damaged and lost, may it be in our own storage or while on loan, perhaps traveling from continent to continent for a new exhibition. But when it comes to data security we often rely on our IT departments and database managers. In a changing world we need to add data security to our registrar’s toolkit because if we don’t care about it, perhaps no one will be left to care about it. So, I am planning on writing a series of short articles on that topic.

Now, I am not an IT expert by any means. I am basically pulling together what I have learned over the years, drawing from resources I have at hand, ready to stand corrected and update you if something I wrote could be done better, easier, and/or more secure. I am thinking in this day and age, any guidance and ideas on how to safeguard our intellectual heritage is better than doing nothing at all. Feel free to contribute with your own sources and ideas.

I am starting with what I feel most comfortable writing about: Backups.

How often should I back up my database?

This is a risk analysis: How serious will losing all your data since you backed up the last time be? In some cases, once a week can be sufficient if you are the only person who works with it, you have all your changes tracked in another medium (for example written notes on paper), and you don’t enter more than just a few records a day. But if multiple people enter and change data during the day? Well, once a day seems highly recommendable, then.

What is the difference between full backup and differential backup?

A full backup stores ALL data of your database. A differential backup only records the changes to the last time you did a full backup. Which one to use when is about analyzing the risks associated with it. A database can get compromised without you noticing right away. In this case it is good if you can revert back to a full backup of an earlier stage, before it became corrupted and then try to extract the data that was added at a later stage from the other backups.

What backup method should I choose and how many backups shall I retain?

There are no hard rules and usually it is best to talk to experienced users of the same collections management system and to the vendor about what makes sense in your use case.

My rule of thumb: If I know I am entering more than ten records each day and do a lot of updating of other records, I will go with a differential backup every day and a full backup once a week. I will keep the backup of the last three days and a full backup from each of the previous four weeks.

But this is tailored for the case where only I enter data and nobody else. If you have a lot of people entering data there are more options of something going wrong, therefore you will want to do backups more often. This is of course also a question of how much storage space you can afford, but then again, you have to factor in the costs of losing data and the hours it takes to re-enter it. Do a proper risk analysis for your institution, then set up a fitting backup routine.

Where shall I store my backup?

Storing your database backup on the same computer you took it is as good as having not stored it at all! When your computer is destroyed either physically pr by a virus, you will have lost both your original database AND your backup.

Best practice is to have three instances of your data:

  • the original
  • a backup on site
  • a backup offsite

A cloud storage might be a good idea for the latter. In this day and age, maybe even a cloud storage outside of your own country. That way, if you are forced to delete data from your database (if this sounds like a far-fetched idea, let me remind you of this https://www.theguardian.com/us-news/2025/mar/07/military-images-trump-dei) your data will still be somewhere safe and unchanged.

You can also use an external hard drive that you store somewhere safe, preferably outside of the town or city your original database is situated because if there is a catastrophe in this area, your data might still be safe somewhere else. It has the advantage that you pretty much can control where your data goes and that it can’t be hacked, but the disadvantage is that if something happens to that hard drive, the data is lost.

In comparison, a cloud usually has its own backup routines that make sure that your data is safe. Ask the provider about it. Also ask them about their security measures and what data they share with third parties. Only you should have access to your data, nobody else.

Heads up: Make sure your data is actually backed up!

Just because you have taken a backup doesn’t necessarily mean you have a working backup. Once you have created a backup file, try if you can restore it. Caution: Restore it to a separate space, don’t use it to restore your actual database because you risk damaging a working database with a corrupted backup. Check this regularly and don’t assume that just because you can see a backup file on your drive your data is actually fine.

Final thoughts on when to delete backups

As said before, it is good to retain some backups because not all problems are discovered right away and it might take weeks to discover them. This is about keeping your current data safe and retrievable.

But you also might want to preserve the state of your current research. In the future, you might want to come back and compare how facts were recorded in 2024 and how that changed going forward. Your past records may become sources for future scientists and historians. So, it might be a good idea to take a backup NOW and keep that backup in a safe space for the future.

Next up I will be showing you how to take a backup if you are using TMS or TMS Collections. The way it is done in your software might be different, but perhaps it is a bit similar.

Take a backup now and take care!

Angela

"When evaluating documentation’s role, consider these broader strategic questions:

- Strategic positioning: How does documentation support the company’s core strategic approach?

- Competitive advantage: Can documentation create or enhance the company’s unique market position? What type of documentation does the competition offer?

- Value proposition: How does documentation contribute to the product’s overall value for customers?

- Knowledge management: How does documentation support internal knowledge retention and transfer?

- Customer lifecycle: How can documentation improve customer acquisition, retention, and satisfaction?"

thegooddocsproject.dev/blog/ma

"When evaluating documentation’s role, consider these broader strategic questions:

- Strategic positioning: How does documentation support the company’s core strategic approach?

- Competitive advantage: Can documentation create or enhance the company’s unique market position? What type of documentation does the competition offer?

- Value proposition: How does documentation contribute to the product’s overall value for customers?

- Knowledge management: How does documentation support internal knowledge retention and transfer?

- Customer lifecycle: How can documentation improve customer acquisition, retention, and satisfaction?"

thegooddocsproject.dev/blog/ma

Replied in thread

@dougmerritt @AmenZwa Calling it "vibe-coding" makes me a bit sick to my stomach. Like "refactoring", a word for a concept that doesn't need to exist. Dark matter.

LLMs are basically manual pages you can ask to write a snippet. There is no "I" in "LLM", but it is a better way to access the manuals for sure. I don't want to have to read all 100 pages just to find the function call I need, I only want to _ask the book._

Si j'étais pas en reconversion, je postulerais sans doute x)

Le poste a l'air trop cooooool !!

Responsable Secteur Documentation
pour les agents, les élus de Nantes Métropole

Typiquement j'aurais postulé y'a 1 an

emploi-territorial.fr/offre/o0

www.emploi-territorial.fremploi-territorial.frLe portail de l'emploi dans la fonction publique territoriale : les employeurs territoriaux recrutent !

I'm finding converting my personal tech notes to public blog posts more challenging than expected.

They've served me well as quick reference docs, code snippets, & cheat sheets. But they look like utter shit when I consider another person looking at them.

I've leaned too heavily on editing, proof-reading, & expanding existing public docs that my writing from scratch has atrophied.

It's a bit of a struggle; but, I want to get these off my local machine and improve my writing.

RiverREM - Generating River Relative Elevation Model (REM) Visualisations
--
github.com/OpenTopography/Rive <-- shared GitHub repository
--
opentopography.github.io/River <-- shared documentation
--
opentopography.org/blog/new-pa <-- shared Open Topography blog post about RiverREM
--
H/T Heidi Luchsinger / Open Topography
[this post should not be considered as an endorsement of this product aka caveat emptor]
#GIS #spatial #mapping #remotesensing #earthobservation #Python #LiDAR #RiverREM #visualisation #hydrology #water #river #rivervalley #floodplain #terraces #GitHub #opensource #opendata #DEM #REM #model #modeling #RiverRelativeModel #documentation #tutorial #learning #tool #elevation #raster #sinuosity #drainage

📅 Mark your calendar, grab a coffee ☕ — on April 30 (2–4pm CEST) you're invited to our #DocsReviewParty!

After a long road, the #Decidim documentation is finally updated to the latest version. Now we need you to help us review it!

Your feedback on structure, clarity, and content will help improve the docs for everyone — and it's a big step toward our goal of multilingual, community-driven #documentation by 2026.

🔗 Register: meta.decidim.org/assemblies/ei

📚 Check the docs: docs.decidim.org/en/v0.29/inde

So, have you been attentive and studied our landing page in detail? 🔍 Then you should have noticed two things: the link to the redesigned documentation and the hamburger menu on the mobile site. 📚🍔 In our digital Deploio library, you'll find everything you need to know about the turbo for your app hosting – from tips and tricks to instructions and help with problems. 🛠️🧰 What are you waiting for? Bring us your code and we'll do the rest. 🚀 #landingpage #documentation #mobilemenu #deploio