Writing technical documentation - tutorial with Confluence

Поділитися
Вставка
  • Опубліковано 15 жов 2024

КОМЕНТАРІ • 117

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

    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

  • @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

  • @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!

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

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

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

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

  • @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. 👍

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

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

  • @yogamac
    @yogamac 2 роки тому +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  2 роки тому

      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 😉

  • @kalmsoulatwork
    @kalmsoulatwork 3 місяці тому

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

  • @franklee8032
    @franklee8032 5 місяців тому +2

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

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

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

  • @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.

  • @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!🥰

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

    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  8 місяців тому

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

  • @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?"

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

    Thanks for this video !!!

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

    Thanks man! my problem is solved.

  • @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.

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

    Sehr Sehr gut video mein bruder. Vielen dank!!

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

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

  • @amrtkaur1996
    @amrtkaur1996 2 роки тому +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  2 роки тому

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

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

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

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

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

  • @Flora_GrootIQ
    @Flora_GrootIQ 9 місяців тому

    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.

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

      I don't have any sample documents, unfortunately

    • @Flora_GrootIQ
      @Flora_GrootIQ 8 місяців тому

      Cool..@@christianlempa

  • @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.

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

    very helpful and looking for more content like this.

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

    Thanks for sharing this awesome tool

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

    You are the man!!!

  • @julianhahn01
    @julianhahn01 10 місяців тому +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 Місяць тому

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

  • @natalka_hanaha
    @natalka_hanaha 2 роки тому +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  2 роки тому +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

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

    What exactly can confluence do what notion cant?

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

    can you show us an example of complex tech docs?

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

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

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

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

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

    It's interesting need more content

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

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

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

    Nice explain sir...thanks a lot🙏

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

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

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

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

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

    Thank you

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

    Great Sirrr

  • @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

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

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

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

    Can you make a video about technical user manual

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

    very nice explanation :) thanks

  • @DhruvVarshneyLearningAccount

    -confluence,zira, and github

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

    It's basically everything that a documentar already know.

  •  Рік тому

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

  • @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.

  • @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!

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

    Please let me know next video for documentation

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

    How to make flow chart

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

    amazing content, good luck

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

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

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

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

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

    looks very similar to Notion

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

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

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

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

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

    Please share some technical documentation for Production plant process

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

    Google doc

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

    like number 889.

  • @subhasankarbhattacharya3454

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

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

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

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

    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.

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

    Ruhig auf deutsch

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

    Blah blah

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

    Useless