Software tools for creating awesome engineering documentation

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

КОМЕНТАРІ • 51

  • @_-martin-_
    @_-martin-_ 4 роки тому +9

    FYI - Markdown is simply a specific implementation of the category of languages we call Markup. For sure markup languages are the future way of documenting especially technical engineering projects, small and large.

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

    This is one of the best tech videos I've seen. Good balance of telling me about a couple things I hadn't seen before, and showing how to use. The completeness of your references and toc in the description was so useful.

  • @gold-junge91
    @gold-junge91 3 роки тому +2

    Thanks for this video. I’m mechanical Engineer and this give me a lot of ideas 💡 how i can make nice documentations

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

    It feels like you unloaded your brain into a video. Very interesting and amazingly useful tips, thank you for sharing your knowledge.

  • @151manasa
    @151manasa Рік тому

    thanks you for the info. I have been slopy with my documentations over the years. I will get back on track with your advice.

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

    Thank you for this! I recently started a new technical writing job with a team that needs their code documented and these are great tips.

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

    Nicely presented. Lucid and to the point. Thanks for sharing.

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

    Thanks a ton for sharing these tools. It’s been a struggle to draw flow charts with drag and drop tools.

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

    Just awesome
    Beautiful and well explained demos
    Will use in my Network security blogs and diagrams

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

    Absolutely wonderful !! Thank you so much Sayanee for this extremely useful & informative walkthrough of markdown.

  • @5u3r73
    @5u3r73 2 роки тому

    Amazing tools to create technical docs! Thanks a lot for sharing, new subscriber :D

  • @ranjithmkumar
    @ranjithmkumar 4 роки тому +1

    This is a great video. Also it is not surprising that Hardware folks are never aware of JS frameworks. I have worked both on web application and embedded application. Never thought of making use of these js libraries for use. Thanks!!

    • @sayanee
      @sayanee  4 роки тому +2

      Yes, you have identified the skill or awareness gap between the hardware and web developers correctly :)
      As I learn how to use these skills from both areas in IoT technologies, I hope to share them in such videos as well.

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

      @@sayanee Looking forward. I am also watching the videos that I have missed from the channel.

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

    Great info,thanks, Many organisations still use microsoft word as primary documentation software, (ultimately it is duplicated in fancy Adobe suite but mostly it starts with ms word) which is probably worst choice. Text based document is way to go forward.

  • @ubidefeo
    @ubidefeo 4 роки тому +1

    Thank you for another great video, Sayanee.
    I didn't know about Wavedrom, it's amazing :D

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

    This is very helpful. Thank you for the details.

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

    I was in need of something like this without even knowing it :D Very helpful tutorial

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

    Excellent video

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

    awesome, wish I had saw your clip year ago, so productive!

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

    Beautifully explained!!⭐❤

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

    This is awesome, I'm now subscribed!

  • @AliG.G
    @AliG.G 3 роки тому

    OMG interactive html bom is soo cool

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

    Great info. Thank you!

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

    Your videos are always very useful. Great content !

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

    Wow, very helpful.... Great video thank you :)

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

    Thanks Madam.
    From south India.

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

    Great video 💚 It has given me so many ideas to implement in my ongoing projects

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

    Great methodology 👍💖

  • @AliG.G
    @AliG.G 3 роки тому +1

    omg, this is so good. I have been looking for something to draw a timing diagram for years. Do you have anything to draw geometric diagrams especially representing angles?

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

      If it's anything more complicated like geometric diagrams, I'm guessing you will have to use hand-code SVG. Maybe try d3js d3js.org/

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

    2:20 Cool tool, but the generator on github pages doesn't support it. Fortunately, you can include a third-party template. You do not need to copy the template to your repository. 👍

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

      Yeah, all the Markdown-based documentation won't be supported when you view them on GitHub or any other Markdown reader. I prefer to simply render them as a webpage / HTML and send the URL to the readers. Either way, as you mentioned there are many other options 🙏🏼
      Could you give an example of a third-party template? I didn't understand that part about copying the template to my repository 😅

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

      @@sayanee Yes please. Here is an example of loading a third-party template, while graphs are drawn directly on the site.
      github.com/kc-doam/manual/
      As it turned out, in the settings not needed.
      *plugins:*
      *- jekyll-remote-theme*

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

    Hey, thank you for the great video, can you please tell us the name of the book and author Documentation on your desk please.
    Thanks!

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

      It's actually the August 2018 edition of Increment increment.com/about, a print and digital magazine by Stripe stripe.com: increment.com/documentation/

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

      This is great thank you!

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

    Very good. Thanks.

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

    👍🏼 learnt a lot in such a short time… #writethedocs

  • @1566chandra
    @1566chandra 2 роки тому

    Thank you so much

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

    What is the colour scheme that you're using in iTerm2?

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

      Oh no! I keep changing it 😅 I believe this one was either Atom or Material dark theme. Even within Atom / Material, they have variants.

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

    Great video, thanks 👍

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

    Good work 👍❤

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

    Thank you

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

    Bengali?

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

      Yes, I am :)

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

      dekhei bujhechi..amio didi.. nice to meet you..

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

      @@sandhyaash7134 Amaro khub bhalo laglo!