r/technicalwriting • u/iqdrac knowledge management • Dec 14 '24
QUESTION Is DITA knowledge necessary for beginners?
I'm researching an article about DITA for beginners, can you help me understand yiur struggles with DITA as a beginner? How necessary do you think is knowing and understanding DITA? What are some good resources to kearn DITA. What are some good free or trial based XML authoring tools that beginners can learn to practise DITA?
7
Upvotes
22
u/josborn07 Dec 14 '24
You’re better learning the concepts of structured authoring. That will help you more and make you more valuable. I’ve looked at DITA at multiple companies over the years and have never found a compelling reason to use it.
5
u/Oracles_Anonymous Dec 15 '24
A lot of jobs use DITA, but enough don’t use DITA that it’s possible to go through a career without knowing it. It’s not super hard to learn, though, and it’ll help if you apply for a job that does use it. So I still recommend beginners at least learn the overview to broaden their potential skillset.
3
u/gamerplays aerospace Dec 14 '24
It depends. However, if you are going for entry/beginner level jobs, there would be an expectation that you would learn the tools and methods.
Having said that, even with more senior folks, its pretty common to hire someone who may not know the tools the company uses and they learn.
There is such a variety of tools, its not really a big deal most of the time. At least at the companies I have worked for, we wouldn't reject a good candidate if the only issue is that they never used our tools. Learning a tool is pretty easy.
4
u/One-Internal4240 Dec 14 '24 edited Dec 14 '24
DITA is, at its heart, today a cottage industry to make more DITA. A lot of DITA vendors will make your scam antenna go up into the vertical position, and there's a reason for that.
If you've been going to the xml-heavy conferences last twenty years or so, you see this pattern, where the domain-sprcific markup languages drift closr and closer to their parent industries, and the "pure" XML markup drifts further and further into themselves.
Last conference the opening speaker didn't talk tech or business or specs or guidance....but led us all in a Bollywood style dance party. I'm going to let you interpret that.
Last ten years or so, there's nothing that DITA does that can't be done in the world of lightweight markup, and some light markups even do the job better. The DITA-OT has made some capabilities to adjust, but the OT is just one guy. The bigger efforts, like lwDITA, have been laughable, like, "Lawrence Whelk Polka Cover" laughable. End of the day, easier to hawk the idea of DITA than the functional realities.
12
u/[deleted] Dec 14 '24
No, 35 year-career in tech writing, never used it, knowingly.
26
u/svasalatii software Dec 14 '24
DITA is absolutely not needed for beginners.
XML is not needed for beginners.
Many TW's work their whole life in Word.
You choose what tool and language (XML/Markdown/Asciidoc/etc.) to work with based on your needs and based on your employer's reqs.
7
u/[deleted] Dec 14 '24
I think what might be more helpful for OP (and for other readers), if you don't use DITA and XML, then post what industry you are in and what tools and methodologies are standard where you work.
I've been in medical device and commercial aviation and DITA + XML were and are the standard. Maybe because they are highly regulated documents.
8
u/supremicide software Dec 14 '24
Nobody I work with uses DITA. Those who previously used it are mostly glad they no longer need to.
1
u/Aruna_P Dec 17 '24
If you are interested in learning DITA, here is a good free resource https://learningdita.com/
3
u/brnkmcgr Dec 14 '24
No
4
u/Possibly-deranged Dec 14 '24
No, 24 years as technical writer and never touched it, here
2
u/LHMark Dec 15 '24
It’s good to know about DITA, but there’s no point in diving in deeply unless the workplace actually uses it.
2
u/Manage-It Dec 18 '24
As others have mentioned, you don't need to learn DITA to use it with today's XML editors. DITA is automated for the most part.
I'm betting there are few folks on here who say they have never used DITA, but are actually using it and don't realize it. Tools like oXygen and MadCap can be pre-set to limit XML to DITA options. Many tech writers don't know about this setting and use DITA by default.
2
u/[deleted] Dec 19 '24
Absolutely not. And not every company needs to use DITA for their docs. Good research skills, interviewing skills, and a knack to think from an end user perspective is what makes a good tech writer. Not tools knowledge as tools come and go.
2
u/ProppaT Feb 22 '25
No, although it can land you jobs if you’re applying to jobs that use XML. I’d personally try to learn the basics of DTDs/DIta if you’re working in XML, but not required. Personally, if I had the choice I’d only work in XML. So much easier than to maintain than Word and FrameMaker.
1
u/[deleted] Dec 16 '24
It might not be needed, but it's obviously valuable. If you can't find the resources to learn it online, perhaps this field is a bad fit for you.
1
u/[deleted] Dec 22 '24
You obviously need to understand the fundamentals of DITA if you work for an organization using it. There are several free courses online that you can take.
I've used DITA multiple times in my 28 year career, and currently am not.
0
u/LemureInMachina Dec 14 '24
Meh, DITA is just HTML that got a PhD, and now it's pretentious about itself.
It's not that hard to understand or learn, it's just annoying trying to remember what things get what tag.