#NSU received the newest #DITA self-propelled vehicle

Commander of the National Guard #Pivnenko made public a photo with these artillery installations. It turns out that the National Guardsmen became the first recipients of #DITA self-propelled guns as part of the Defence Forces of #Ukraine.

#DITA systems are manufactured by the #Czech defence company #Excalibur_Army, and their production was paid for by the #Netherlands and other European countries.

Where's the lie
#DITA #markdown #techwriting #docsascode

#TechnicalWriting #SoftwareDocumentation #Markdown #XML #DITA: "Think about how in Markdown you would ensure that “all our how-to guides must have an h1 title, followed by one or more paragraphs, followed by one or more steps to achieve the guide’s goal”, and then consider how easy it is in DITA.

This is just not really possible today, at least in any popular Markdown-based framework.

There is a path
Bridging the gap between Markdown and structured authoring will require building new tooling and standards. It’s unlikely that CommonMark or any other popular Markdown flavor would consider going in this direction, so we’ll have to create tools around Markdown.

We at Doctave have some ideas about how to achieve this, and have a roadmap on how to get there. At a high level there are a few things we would need:

A parser and template system that is Markdown-aware
A language for describing constraints and rules for your Markdown content
An engine that enforces those rules on your content
We’re already part of the way there!"

https://www.doctave.com/blog/path-to-structured-markdown

PEOPLE: Madonna's Final Celebration Tour Stop in Rio de Janeiro Draws Record-Breaking Audience of 1.6 Million

https://people.com/madonna-celebration-tour-rio-de-janeiro-draws-record-audience-8643456

The show made history as, though the annual New Year's Eve concerts at Copacabana Beach have drawn larger crowds, Madonna's May 4 audience was her biggest ever, and the largest ever for a stand-alone concert by any artist, a record previously held by The Rolling Stones.
---
Music makes the people come together.
#Madge
#Madonna
#Dita

#TechnicalWriting #DITA #XML #DITAXML #Documentation #InformationArchitecture #StructuredAuthoring: "DITA is defined in its specification as “an XML-based architecture for authoring, producing, and delivering topic-oriented, information-typed content that can be reused and single-sourced in a variety of ways”. Originally developed by IBM in the early 2000s, DITA stands for Darwin Information Typing Architecture. “Darwin” refers to the naturalist Charles Darwin and his theory of evolution, reflecting DITA’s principles of specialization, inheritance, and adaptation.

DITA topics are standalone, context-free blocks of content, with content types kept clearly separate. There are three main topic types in DITA, all of which are inherited from the base topic type <topic>:

<concept>: background information that users must know before using the product

<task>: step-by-step instructions that users need to perform a task

<reference>: product specifications, commands, or other reference material

You create a document by selecting which existing topics should be reused and referencing them in what’s called a DITA map (similar to a table of contents).

Being an open standard, DITA has no proprietary restrictions. But while you’re not forced to buy a specific tool to use it, commercial XML editors have many features, such as visual editing and validation, that make writing DITA content much easier."

https://mastertcloc.unistra.fr/2024/04/26/dita-xml-documentation-reasons/

@failedLyndonLaRouchite I use Beyond Compare for *source* comparison. As a #technicalwriter I author in #DITA which is an xml specialization; nice because I can use the same toolchains and repos as my dev teams.

And BC *can* diff PDFs almost as well as Acrobat (in some cases better), so long as you're ok with it having scraped all the text out of it to do so. Which may or may not be what you want, but in that case, y not just diff the source.

https://en.wikipedia.org/wiki/Standard_Generalized_Markup_Language#:~:text=SGML%20descended%20from%20IBM%27s,in%20%22The%20SGML%20Handbook%22.

As I possibly need to do soon something with #DITA.
DITA which is based on XML with some DTD is as like as HTML derived from SGML. In fact HTML is a simplified SGML.
I was aware that #SGML was developed at Boing. They invented it for Airplane documentation.

Today I learned that SGML is based on GML: "General Markup Language" from IBM.
But maybe simply "Golfarb, Mosher, Lorie": the #IBM engineers back in the 1960s.

#TechnicalWriting #SoftwareDocumentation #DITA #CCMS: "Whether we are talking about technology, governments, business, culture, or the environment – we live in a world of constant change. In our field of work, many of us see changes impact our documentation on a weekly, if not daily, basis. To keep pace with these changes and maximize content reuse, it has become standard practice to employ some form of topic-based authoring tool.

However, when technical communication professionals consider their content authoring and management strategies, the best solution is not always clear. Does it require a component content management system (CCMS) based on the Darwin Information Type Architecture (DITA)? Or will a more general solution for topic-based authoring provide the necessary features?"

https://tcworld.info/e-magazine/intelligent-information/dita-vs-topic-based-authoring-systems-1301/

#TechnicalWriting #DITA #Markdown #SoftwareDocumentation: "Moving from DITA (Darwin Information Typing Architecture) to Markdown for technical documentation involves weighing several benefits and risks, which are pertinent to the specific needs and workflow of technical writers

While Markdown offers notable advantages in terms of productivity, collaboration, and alignment with modern development workflows, it also presents significant challenges in content structure, scalability, and feature richness.

Technical writers must be prepared to navigate the less-structured environment of Markdown and may need to employ additional tools and practices to compensate for the loss of certain key capabilities inherent in DITA’s more complex system.

The decision to transition should therefore be made with a thorough understanding of these trade-offs and an assessment of the specific needs of the documentation project.

Let’s dive in."

https://www.ihearttechnicalwriting.com/2024/01/08/what-are-benefits-of-adopting-markdown-v-dita-for-technical-documentation/

Neues Video: Kompakte Grundlagen zum Thema #DITA aus einer im Sommersemester 2021 online gehaltenen Vorlesung. https://vimeo.com/910787929

I might be a little late to this, seeing as I've been writing in DITA for a decade, but this morning I'm finally getting around to learning syntax diagrams.

New #introduction toot, since I moved over to my own instance:

I'm Mike. He/him, il/lui. I live on unceded and unsurrendered Wolastoqey territory. I'm #bisexual and #polyamorous. I have two partners, one kid, one dog. I have #adhd. I'm a #technicalwriter, mostly working in #dita, and I code a little in #python. I write fiction and poetry on the side. I play #dnd and #bass. I like #hiking, #linux, #dogs, #DoctorWho, #StarWars, #reading, #history, etc.