Writing technical documentation - tutorial with Confluence

Поділитися
Вставка
  • Опубліковано 11 січ 2025

КОМЕНТАРІ • 121

  • @TheDedicatedFew
    @TheDedicatedFew 4 роки тому +237

    I wish you had actually shown how to write documentation instead of explaining why you should write documentation. If you end up here, I think you already came to that conclusion.

    • @christianlempa
      @christianlempa  4 роки тому +16

      Hi, thank you for so much for your feedback! I'm sorry that you're a bit upset about this, but it's an interesting idea for a second part or an example video about documenting a software project, business case, etc.

    • @zairahira3447
      @zairahira3447 3 роки тому +4

      Many people don't know the importance of documentation, so this tutorial is excellent for that audience. A brief tutorial on how to write documentation is covered in this video and I found it useful. however, the documentation content should be with the respective domain expert :)

    • @antoniocampbell3574
      @antoniocampbell3574 Рік тому +2

      I was thinking the exact same thing.

    • @lillyshaw9439
      @lillyshaw9439 Рік тому

      @@christianlempa I needed this first.
      I would love a way of doing it.
      We have confluence cloud.
      I need to write a user guide for a Web application engineering tool that can be accessed on port 8080 from the core cluster nodes.
      There are so many aspects to it that I don't know if I should write one doc explaining applications.
      The a user guide explaining each module - jobs, transfer, core services separately.
      Then troubleshooting guide. So confused!!!

    • @lillyshaw9439
      @lillyshaw9439 Рік тому

      Thank you! I enjoyed it. We use Jira too

  • @Declan_dice
    @Declan_dice 3 роки тому +17

    This is exactly what I was looking for. Appreciate it fam!
    Just got my AWS job so it helps me alot

  • @BigBrainHacks
    @BigBrainHacks 3 роки тому +5

    I'm a Software Engineer and suck at- / don't like writing documentation. This video motivates me to give it the attention it needs. Thank you!

  • @Halsafe
    @Halsafe Рік тому +6

    Just finished a fully automated driver management utility for my job and yeah I agree with the statement that documentation is everything. I create quite a few documents (I've written almost 150 SOPs and troubleshooting guides for my job) but this video really drove why we do certain things while documenting home with me.

    • @rey6760
      @rey6760 Рік тому

      May I know what is the driver management utility that you use, please? thank you

    • @Halsafe
      @Halsafe Рік тому

      @@rey6760 sorry cannot share it as it’s designed specifically for my environment

  • @mindblowinglyrics55
    @mindblowinglyrics55 3 роки тому +5

    I knew there was a way to document, but didn't know exactly how, this was helpful

  • @jingli9232
    @jingli9232 2 роки тому +2

    need more about this confluence topic, thx for this valuable knowledge

  • @ebarednaxela
    @ebarednaxela Рік тому +1

    Hi Christian! Thanks for creating this video. I learned new stuffs from it and for sure it will help me in my IT career. Surely I will share this to my colleagues. Two thumbs up! Cheers mate!🥰

  • @HEWfunkingKNEWit
    @HEWfunkingKNEWit 4 роки тому +11

    I realised this early on when trying to redo odoo installations. I decided to write a concise documentation and it definitely helps. Didnt know that I could include it as part of my resume though. 👍

  • @kalmsoulatwork
    @kalmsoulatwork 6 місяців тому

    Very helpful information for someone who's looking to dip their feet in technical writing and documentation. Thank you!

  • @darkmodealliance1269
    @darkmodealliance1269 2 роки тому

    Christian ich bin gerade auf deinen Kanal gestoßen und klasse Videos! Man bekommt unglaublich viel Input für die kurze Zeit, aber es ist dennoch strukturiert und nicht zu schnell. Die meisten Videos scheitern genau an dem Punkt und neigen dazu "zu schlicht" oder "zu kompliziert" zu sein.

    • @christianlempa
      @christianlempa  2 роки тому

      Vielen Dank! Freut mich sehr das zu hören :)

  • @st1llbleed1ng
    @st1llbleed1ng 2 роки тому +2

    Even with playback speed to 1.5x which comes down to near about 9:38, i felt like my time was robbed!
    Wish you could change the title to "should you write technical documents? Where do you start?"

  • @akshatsharma264
    @akshatsharma264 Рік тому

    Sehr Sehr gut video mein bruder. Vielen dank!!

  • @franklee8032
    @franklee8032 7 місяців тому +4

    Where's the tutorial on how to write a technical documentation with Confluence?

  • @LeoNux-um7tg
    @LeoNux-um7tg 23 дні тому

    I couldn't afford to buy ccna cert as of now, so documenting my journey might help me to land any higher paying job than my current one and hopefully get a ccna cert in the future.

  • @Bolgerish
    @Bolgerish 2 роки тому

    Schönes Video Meiner. Confluence hab ich gesucht. Danke für deine kurze Einführung.

  • @danibullo
    @danibullo 2 роки тому +1

    At my current job, trying to explain this behavior of properly documenting the work done in a daily basis using Confluence with infographics, because they love to create huge text documents which nobody will ever read.

  • @themindhealer6912
    @themindhealer6912 3 роки тому +1

    Thank you for this amazing tutorial! I use Jira but was not aware of this Confluence!

  • @yogamac
    @yogamac 3 роки тому +5

    This is not How To Write Technical Documentation. It’s just How to Navigate Technical Document management systems. Technically it’s not even a tutorial. It’s an introduction to Confluence.

    • @christianlempa
      @christianlempa  3 роки тому

      Well, you could just make your own video and share your knowledge and experience with us. Would be great to have more Content on this topic 😉

  • @ashiphsayyad3074
    @ashiphsayyad3074 2 роки тому +1

    I m learning new things n side by side creating documentation in notepad++....I forgot there is tool for documentation 😅😅Thank you

  • @sravankumar4750
    @sravankumar4750 2 роки тому

    very helpful and looking for more content like this.

  • @nate806
    @nate806 3 роки тому +2

    I just subbed because this was awesome. I needed something exactly like this.

  • @zahidshaikh3122
    @zahidshaikh3122 2 роки тому

    Thanks man! my problem is solved.

  • @Malpekar-mo4wb
    @Malpekar-mo4wb 7 місяців тому

    Thanks for this video !!!

  • @liarahmi2174
    @liarahmi2174 11 місяців тому

    Hello Mr. Christian Lempa. Nice to watch your amazing and usefully video. I'm from Indonesia. I just interesting with tool that can make a good technical documentation which you explain above (Jira), but if we buy the license of that tool for my company it's too expensive than the other tools. Now in my company use a Click Up. I hope in the next video you can make a review how utilize the Click Up to make a good technical documentation for digital product or project. Thanks

    • @christianlempa
      @christianlempa  11 місяців тому

      Thanks! Honestly, I've tried to use ClickUp, but for me, it just didn't work well, as it's pretty slow and clunky :/

  • @emmanuelricks7166
    @emmanuelricks7166 2 роки тому

    You are the man!!!

  • @Mason-gl4jl
    @Mason-gl4jl 4 роки тому +1

    I will have to give confluence a try looks like something i have been missing. I normally use one note for all my documentation. i like how confluence has templates.

  • @roni-ahamed0
    @roni-ahamed0 24 дні тому

    helping video. Thanks

  • @TheRealJohnMadden
    @TheRealJohnMadden Рік тому

    I used to work at a company that used Confluence for their knowledgebase, I loved it so much that basically, every personal project I take on that requires a lot of documenting now goes into my own personal Confluence site. I also just started moving my current company's documentation from OneNote (yuck!) into Confluence for a beautiful and easy-to-navigate site for all help desk and new IT staff to easily troubleshoot common issues or to confirm policies or procedures. It's an amazing tool and I love when things are free because you're either a single person or have a really small team, that's a HUGE plus for me. I personally love technical documentation, just knowing that when I move on someone else will find what I wrote useful is amazing.

  • @Flora_GrootIQ
    @Flora_GrootIQ Рік тому

    Sounds Amazing 👍, can you please share the sample document confluence links for (Userguide/Troubleshooting/Networking/Instruction guides) and how to maintain version control in confluence.

  • @emmanuelelisha8912
    @emmanuelelisha8912 3 роки тому

    Thanks for sharing this awesome tool

  • @amrtkaur1996
    @amrtkaur1996 3 роки тому +3

    Hi
    Your video is really very helpful👍👍👍
    Could you please make detail video on how to use all the features of confluence like adding link , inserting JIRA tickect ,inviting other people to edit the document.etc

    • @christianlempa
      @christianlempa  3 роки тому

      Thank you! Well yeah maybe I'll do that in the future

  • @natalka_hanaha
    @natalka_hanaha 3 роки тому +6

    Thank you for this video) I'm a technical writer from Ukraine. We use Confluence and Jira in our company. I've written several guides for small applications we have - and I've met some problems. Firstly, I can't paste a small image directly to the text row - for example, images of buttons or marks. Secondly, I see no navigation tools on the page while editing - TOC appears only after publishing. So it's hard to make some kind of 300 pages user guide with one Confluence page, I need to add a new page for every chapter. But then I'll have to export all pages separately. So now I think Confluence is more useful for small documents - 30 pages or less. I'd love to read your advice - do I have to learn Confluence more, maybe I've missed something, or it's better to search for another documentation software? Thank you one more time) Have a good day)

    • @christianlempa
      @christianlempa  3 роки тому +1

      Thank you for the great feedback! However, we're using confluence pretty well in our company, even for complex docs.

    • @lillyshaw9439
      @lillyshaw9439 Рік тому

      Do you have scroll documents installed?
      Are you using cloud confluence? I usually put images in tables with barely any outline, then you can put the text for the image in the second row.
      Just don't use a header for the table.

    • @hardishah3188
      @hardishah3188 Рік тому

      Have u tried notion?

  • @sandeepm3528
    @sandeepm3528 2 роки тому

    Very useful video thanks

  • @oatlylatte9
    @oatlylatte9 Рік тому

    can you show us an example of complex tech docs?

  • @catm71
    @catm71 3 роки тому

    Don't forget you can always ask your Technical Writers, that's what we're here for!

  • @vpsingh7191
    @vpsingh7191 2 роки тому

    Nice explain sir...thanks a lot🙏

  • @JersGirl1988
    @JersGirl1988 7 місяців тому

    Can you export a user guide you have written in confluence?

  • @r4jjin
    @r4jjin 3 роки тому

    very nice explanation :) thanks

  • @julianhahn01
    @julianhahn01 Рік тому +2

    hm, usually I applaud your videos. A little bit disappointed of this one.
    The message after finishing the video is basically:
    You should use documentation. Think of a structure. Make it interessting. Just use an template import.
    First of all I don't think, that your last point and how you end the video matches the first three points. I was hoping for a video, in which you share best practices on software documentation. What structures worked and which did not work. Maybe especially in Confluence. My main paint point in confluence is, that I basically create "folders" with the sub pages, but most of the "folders" are then just empty pages, and the important content is in the "leafes" or the lowest pages. I would guess, that a reader would quickly get frustrated if he/she stumbles over too many white pages which only serve a structuring purpose.
    That and problems like it, I would have loved to see in this video.

    • @houdaifabouamine
      @houdaifabouamine 4 місяці тому

      hi,
      we share the same thoughts,
      can you suggest a good content about that?
      thanks in advance

  • @arifsumarna0465
    @arifsumarna0465 3 роки тому

    Great Sirrr

  • @pallavraj7797
    @pallavraj7797 3 роки тому

    It's basically everything that a documentar already know.

  • @jacobvarghese668
    @jacobvarghese668 3 роки тому

    Hi, I use bookstack for my documentation. I have hosted in the cloud.

  • @MukeshYadav-up3ul
    @MukeshYadav-up3ul 2 роки тому

    It's interesting need more content

  • @issamsahraoui8698
    @issamsahraoui8698 4 роки тому

    amazing content, good luck

  • @truthandreality2525
    @truthandreality2525 3 роки тому

    Can you make a video about technical user manual

  • @Salamaleikum80
    @Salamaleikum80 Рік тому

    What exactly can confluence do what notion cant?

  • @lillytran3015
    @lillytran3015 3 роки тому

    need help with summary for Documenting the data analysis according to organisational

  • @vladcristian5106
    @vladcristian5106 3 роки тому +1

    You didn't showed us how to write a technical documentation

  • @simon.knudsen
    @simon.knudsen 3 роки тому

    Is their any review and approval feature for document changes?

    • @christianlempa
      @christianlempa  3 роки тому

      I guess that's included, as far as I know.

    • @lillyshaw9439
      @lillyshaw9439 Рік тому

      Scroll documents needs to be installed

  • @DhruvVarshneyLearningAccount
    @DhruvVarshneyLearningAccount 2 роки тому

    -confluence,zira, and github

  • @anon_1858
    @anon_1858 3 роки тому

    Thank you! It helped me get acquainted with the industry standard tools used for technical documentation. Stay safe :)

  • @zaheerbeg4810
    @zaheerbeg4810 Рік тому

    What things I have to mention in technical documentation for mobile application ?

  • @nandkishorgokhe
    @nandkishorgokhe 3 роки тому

    Please let me know next video for documentation

  • @brierepooc8987
    @brierepooc8987 2 роки тому

    Hmm, I’ll just stick to OneNote 😂 It I would run an MSP it would be IT Glue or something self-hosted.

  • @krish0917
    @krish0917 Рік тому

    Thank you

  • @truthandreality2525
    @truthandreality2525 3 роки тому

    How to make flow chart

  • @metternich05
    @metternich05 2 роки тому +2

    I don't like to leave a negative review but the title of this video is extremely misleading. I was expecting to see some actual workflow of creating technical documentation in Confluence but instead you offer some general wisdom, plus basic steps in Confluence that can be seen in another ten thousand videos across UA-cam. Everyone can click on a template and if he's not entirely imbecile he'll understand the purpose of the content items almost immediately. What you can't figure out on your own is how to create a complex, cross-referenced, sturcured and printable, wiki-like documentation that can be used on entereprise level. That would be a proper tutorial. This is just clickbait and a waste of time.

    • @christianlempa
      @christianlempa  2 роки тому

      Sorry you didn’t like it

    • @velFleger
      @velFleger Рік тому

      @@christianlempa He is right! 15 minutes video, where "tutorial" part is about 5 minutes and half of this part is about creating account. Nice tutorial bro!

  • @samirelzein1095
    @samirelzein1095 2 роки тому

    motivate 1 minute, explain 3 minutes, conclude 30 sec. Speak in terms of bullet points.

  •  Рік тому

    I would not recommend Jira anymore. The product is EOL.

  • @just_a_viewer5
    @just_a_viewer5 2 роки тому

    looks very similar to Notion

  • @aayushsinha7882
    @aayushsinha7882 4 роки тому

    Please share some technical documentation for Production plant process

  • @jerryyu5666
    @jerryyu5666 Рік тому +1

    8 minutes 49 seconds before he gets into using confluence. Waste of time.

  • @navjotsingh2457
    @navjotsingh2457 2 місяці тому

    ty

  • @afro_giraffe
    @afro_giraffe 2 роки тому

    The background music is killing me bro, maybe make it really soft and something delightful

  • @vi4dofficial
    @vi4dofficial 2 роки тому

    Google doc

  • @sandeepsinghnegi9220
    @sandeepsinghnegi9220 2 роки тому

    like number 889.

  • @redblue7733
    @redblue7733 4 роки тому

    What is this??????????

  • @Dfeneck
    @Dfeneck 2 роки тому

    Confluence is the most rubbish tool I have ever had to use. Literally every little thing I've set out to do in the documentation can't be done without a paid plugin, paid theme or by taking it off the cloud and running my own instance. I cannot believe this is "industry standard". Honestly, save your time and money, go download Redmine for free, host it, and install the Abacus Theme if you need it to look modern.
    What a waste of money and time confluence is. All marketing. No features. With paid gotcha's.
    Confluence users are fools. Of this you cannot change my mind.

    • @christianlempa
      @christianlempa  2 роки тому

      I'm still trying to figure out what you mean by waste of money if you can use it for free?

    • @Dfeneck
      @Dfeneck 2 роки тому

      ​@@christianlempa
      "...every little thing I've set out to do in the documentation can't be done without a paid plugin, paid theme or by taking it off the cloud and running my own instance..."
      We've settled on a very basic, clean document structure on the cloud, and the company is happy with that, which is great - but personally I won't ever use Confluence for my own projects.
      I find a free solution like Redmine much more powerful, useful and practical.
      Anyway, cheers for the video.

  • @khetaaan
    @khetaaan 3 роки тому +2

    I found this video as a waste of time. You could have wrapped this up in 30seconds or so. Thanks.

  • @subhasankarbhattacharya3454

    Its not helpful why it was how to write what to write waste of time

  • @dandiamant-beautifulisrael6718
    @dandiamant-beautifulisrael6718 3 роки тому +1

    Blah blah

  • @UsernameR8
    @UsernameR8 Рік тому

    Useless