muenchen.social ist Teil des dezentralen sozialen Netzwerks, das von Mastodon betrieben wird.
Hallo auf muenchen.social Dies ist eine deutschsprachige Mastodon Instanz für München zum tröten, neue Leute kennenlernen, sich auszutauschen und Spass zu haben.

Verwaltet von:

Serverstatistiken:

1,3 Tsd
aktive Profile

Mehr erfahren

Antwortete Marcus Müller

@gnuradio Here's the full list of #gnuradio block documentation pages that are mostly just missing an example flowgraph,

wiki.gnuradio.org/index.php?ti

and a list of block doc pages that are just stubs and would *love* to get some attention:

wiki.gnuradio.org/index.php?ti

You're not alone in this! If any questions/problems using the wiki or on GNU Radio #documentation in general arise, you can always find the docs on #Docs:gnuradio.org on matrix. Here's how you join the chat:

wiki.gnuradio.org/index.php?ti

Category:Pages with no Example Flowgraph - GNU Radiowiki.gnuradio.org

Documentation complaints.

The Curse of Knowledge is real in documentation; even big and pricey ecosystems skip basic information.

Two examples I ran into this morning:

1. GitHub's CODEOWNERS documentation does not explicitly mention where to create the file.

docs.github.com/en/repositorie

2. NPM's docs do not explain allowed characters in package names.

docs.npmjs.com/package-name-gu

#WebDev #documentation

About code owners - GitHub DocsGitHub Docs

new & final status update on 'moving image zines rdam':

The complete archive (355 videos) from 2005-2025 has been uploaded & is available on archive.org: archive.org/details/moving-ima

All videos are downloadable as high-quality files [mp4/h264 codec, 32 Mbit/s] and reusable under the Creative Commons Attribution-ShareAlike 4.0 International license.

#video #movingimage #diy #rotterdam #documentation

Internet Archive: Digital Library of Free & Borrowable Texts, Movies, Music & Wayback Machinearchive.org

Focus on what you CAN do, not what you CAN’T

In these past few weeks it seems that there were so many horrible things happening that just making a list of them feels overwhelming and exhausting. Some of the decisions of the current U.S. government have an impact on the global level, others hit people personally, some of whom are close friends. And then, there are those who seem to target the very core of our profession, like the shutting down of the Institute of Museum and Library Services (IMLS) and the termination of grants already awarded by the National Endowment of the Humanities (NEH).

It is hard not to lose all hope in this climate. And yet, aren’t we, as museum professionals, used to things not really looking pretty? Haven’t we battled budget and staff cuts before? Haven’t we brought uncomfortable truths in front of the eyes of our visitors and politicians before? Maybe the current crisis is not comparable to what we were confronted with before. But just as well, we are well trained in going against adversarial circumstances.

We have always done so with resilience, creativity, and, most of all, a sense of community. We might be spread out across the world and we might have spread ourselves thin by taking on too many responsibilities, but we are not alone. I have reached out to my network over the past few days to check in on some people, see how they are coping, and getting ideas of what can be done, because, in the end, focusing on what can’t be done never made anything better.

Turns out that John E. Simmons had already started collecting what can be done to prepare for what is coming at us in something we registrars love: A list.

I contributed a few of my thoughts to it and we also asked some more colleagues to add to it. What I am posting here today is by no means a comprehensive and finalized list of what to think about and what to do, but it is a start. Feel free to add more ideas in the comments section, just like we enhance it going forward.

What Can We Do?

1. Apply the lessons that museums learned from Covid

A museum should have a plan for suddenly shutting down or having to reduce staff for a prolonged long period of time.
The plan should include cross-training for all staff so that a reduced staff can keep the institution functioning and care for the collections. Every staff member should be trained to do tasks that are normally not part of their duties so that they can help in the event of a prolonged emergency.
The plan should include what the museum can do to remain a destination for visitors during a crisis. This might include regulating the number of visitors in the museum at the any one time during a pandemic, reducing or eliminating admission fees for visitors during a prolonged financial crisis, and how responsibilities could be handled by a reduced staff. It is worth noting that a recent study revealed that art museums that charge admission spend an average of $100 per visitor but attract smaller audiences than free museums, and that there are costs associated with collecting admission fees that may not be recovered by the fee. Details can be found at https://news.artnet.com/art-world/us-museums-visitors-report-2622358).

2. Prepare the collections for long-term, low maintenance storage

by preparing the most sustainable and passive storage environment possible:

Improve the effectiveness of the collection storage furniture, containers, and supports to protect the collections (e.g., replace gaskets on doors, eliminate acidic materials, reduce lighting and UV in storage).
Keep the collection in order (each object in its proper place in storage) at all times (do not allow a backlog of out-of-place objects to build up).
Improve environmental controls and environmental monitoring procedures.
Maintain storage environment equipment in good order (e.g. replace filters, service equipment regularly, replace aging HVAC systems).

3. Protect the databases

Make sure that you have a fully up-to-date, readable copy of all important museum databases stored somewhere outside of the building, preferably in a hard format as well as electronic.
Make sure that both on-site and off-site databases are protected so they cannot be accessed by unauthorized personnel. Renew passwords and other project on a frequent, regular basis.
If the institution is forced to close, and you have a good backup copy, consider removing databases from the museum servers to protect confidential information.
When possible look into storing backup copies of your databases that are not only readable in a proprietary format of one vendor (who might be forced to hand your sensitive data over or might go out of business). If you database allows for it, export your important data as SQL tables or as comma separated values (.csv). Excel formats such as xlsx, xls, or ods are fine, too.
When possible move your sensitive data to trusted servers outside the U.S. that don’t belong to U.S. based companies who might be forced to hand your sensitive data over or delete your data.
As a rule of thumb: make access to your data for your trusted staff as easy as possible, but make deleting data from your database hard by setting up a robust rights management and whenever possible enable procedures to revert to earlier data entry points.

4. Update the institutional emergency preparedness plan

to include procedures for coping with sudden, prolonged shutdowns of the building.

5. Stock up on critical supplies

6. Download anything needed from federal websites

(such as the NPS Museum Handbook and Conserve O Grams or IMLS reports) immediately, while the information is still available. Store this data in a safe place that is only accessible to authorized personnel and make deleting those resources as hard as possible.

7. Keep in mind that most serious problem going forward will probably not be the cuts in federal funding

to the NIH, NEA, NSF, IMLS, etc., because most of this money goes to projects which can be postponed or funded by other sources (such as donations). The most serious problem will be the lack of funds resulting from damage done to the economy due to a combination of the rising deficit, increasing unemployment (e.g., the mass reductions in the federal workforce and corresponding loss of jobs in sectors that serve the federal workforce), and decreased tax revenues due to tax cuts for the wealthy, tariffs on imports, and cuts to social services. In other words, the predicted problems with the US economy are far more likely to be a bigger problem for museums than the loss of federal grant funds.

Words of Cheer:

Museums existed long before the IMLS and other federal granting agencies, so they can survive this period, although many worthy projects and much research will be halted unless alternative funding can be found.
With preparation, museums can survive the coming crisis as they have survived other crises. There will be staff reductions and loss of opportunities, but with any luck, the situation will change within a few years.
Take a good look at your policies and procedures and investigate new laws and executive orders you are confronted with. Laws that are passed in a great hurry often contain contradictions and loopholes. Often asking for clarifications by authorities can slow processes down and work to your advantage. Often stalling a process in good faith can be much more effective than open opposition which puts you and your staff at risk.
Be prepared to be patient. Lawsuits and judicial decisions challenging the proposed changes will take time to go through the courts.
In the longer term, climate change and its effects on museum operations, the economy, and the behavior of the public is the greatest challenge to the future of museums, so the present crisis should be used to prepare for the future.

Best Advice:

If your institution does not have a plan for long-term survival during a financial crisis, the next pandemic, or climate change, get busy now to correct this deficit.

Helpful Information

Learnings museums made from the Covid-19 pandemic, https://www.ne-mo.org/news-events/article/learnings-museums-made-from-the-covid-19-pandemic

PEAS Resource Library (Promoting Exhibit Access and Safety), https://ncp.si.edu/PRICE-PEAS

Snider, Julianne. 2024. The Wheel is Already Invented: Planning for the Next Crisis. Collections: A Journal for Museum and Archives Professionals 20(2):347-359, DOI: 10.1177/15501906241232309

Living in a Wild Future (Center for the Future of Museums blog), https://www.aam-us.org/2025/03/04/living-in-a-wild-future/

Decrease in Public Funding? A Worldwide Answer from Museums (ICOM), https://icom.museum/wp-content/uploads/2025/01/IRAPFM-A4-Format_FINAL.pdf

Susana Smith Bautista (2021)—How to Close a Museum. A Practical Guide (Rowman & Littlefield)

Here is an additional list of resources in case you have to close down your institution: https://world.museumsprojekte.de/wp-content/uploads/2025/04/ResourcesMuseumsClosing.pdf

Christopher J. Garthe (2023)—The Sustainable Museum. How Museums Contribute to the Great Transformation (Routledge)

Some more notes

Share this resource freely with anyone you think needs to see this, no need to ask for permission. Add what applies to your special case. Let us know what we should add. Download, save, print, circulate.

Download List as PDF

Registrar Trek is hosted on a server in Germany and following EU laws. I am currently looking through all the plug-ins I use to make sure none of them collects and shares any personal data with the U.S. Or, in fact, anybody. I always was mindful not to collect any personal information but will double-check again if everything is safe.

Hang on in there, you are not alone!

#BudgetCuts #collectionsManagement #documentation #grantErasure #grants #IMLS #museum #NEH #preparingForShutdown #registrar

📽️ Do you agree? High-quality documentation is essential — especially for feature-rich software like OpenProject.

That’s why we keep our guides up to date in English, German, Spanish, French — and soon Portuguese! — while also investing in video tutorials.

In our latest blog article, we share our approach to great documentation and video content, and introduce Dicle, our new Video Production Manager:

openproject.org/blog/video-doc

#Documentation #OpenSource #ProjectManagement #OpenProject #Software

Hawkmoth v0.20 is out!

Hawkmoth is a Sphinx extension to import C and C++ documentation comments into Sphinx based documentation.

The main new feature in this release is automatic configuration of the system header search paths. Unfortunately, libclang does not get them right out of the box on most distros, so we have to help it a little.

#Sphinx #Hawkmoth #Documentation #reStructuredText #C

github.com/jnikula/hawkmoth

GitHub - jnikula/hawkmoth: Hawkmoth - Sphinx Autodoc for CGitHub
Antwortete Roger Light

And this is a possible update. The command synopsis is now split up into multiple logical sections to make it easier to find related options and ignore ones you aren't interested in. As a consequence, it occupies about a full screen height.

I think it's clearer, but I'm concerned the large amount of screen use is offputting.

Any thoughts?

#mosquitto #mqtt #documentation

I am working on creating a handbook that describes the assistive technologies available in the FreeBSD operating system, which will be freely available online for anyone to consult. Currently, the effort is focused on gathering and documenting accessibility features for visual impairments, and it is sponsored by the @FreeBSDFoundation

If you are interested in the topic, a public repository is available for suggestions and corrections: gitlab.com/alfix/freebsd-acces

#FreeBSD #UNIX #OpenSource #Accessibility #a11y #Blindness #LowVision #ColorBlindness #AssistiveTechnologies #Inclusion #Documentation #Coding

"The following are my suggestions regarding what else to consider for each of Daryl White’s excellent questions about choosing a toolset for documenting a software product or project.

I have appended a brief guide to the main/broad categories of documentation toolsets and some of the platforms/components that are popular in each.

Finally, this resource ends with a table of possible solutions for various scenarios you might find yourself in.

Before we start with the existing list of questions, I want to highlight one that I think is most important of all, but which is often assumed by people who create these kinds of guides, as they tend to come from one or another world already.

What are you documenting?

When it comes to software technical writing, the more appropriate way to ask this might be: For what user roles is your documentation intended?

For graphical end-user interfaces (GUIs), the largest range of docs tooling is available, but here some of the more commercial turnkey tools have most of their advantages.

For administrator interfaces (installation, configuration, etc), again any tooling will work, but we start seeing real advantages for lightweight markup, codebase integration, and version control.

For developer interfaces, docs-as-code offers significant advantages. Developers can better contribute directly, and it’s generally friendlier for coded samples. APIs (native and remote), SDKs, and CLIs are almost certainly best documented in a docs-as-code environment, even if you integrate it with a more conventional platform for end-user docs."

gist.github.com/briandominick/

#TechnicalWriting #SoftwareDocumentation #Documentation #DocsAsCode #TechnicalCommunication #InformationArchitecture #CCMS

docs-tooling-choices-guide.adocGist