ML
    • Recent
    • Categories
    • Tags
    • Popular
    • Users
    • Groups
    • Register
    • Login

    Technical Documentation

    Scheduled Pinned Locked Moved IT Discussion
    45 Posts 10 Posters 7.0k Views
    Loading More Posts
    • Oldest to Newest
    • Newest to Oldest
    • Most Votes
    Reply
    • Reply as topic
    Log in to reply
    This topic has been deleted. Only users with topic management privileges can see it.
    • A
      Alex Sage
      last edited by

      What do you use? I am thinking about using Confluence but I wanted to see what you guys are using first 🙂

      coliverC 1 Reply Last reply Reply Quote 2
      • coliverC
        coliver @Alex Sage
        last edited by

        @aaronstuder said:

        What do you use? I am thinking about using Confluence but I wanted to see what you guys are using first 🙂

        We use Confluence here but campus wide. If I were doing it for IT I would looking into dokuWiki or Mediawiki.

        1 Reply Last reply Reply Quote 0
        • DashrenderD
          Dashrender
          last edited by

          I'm really pushing a few departments to start making their own documentation.

          Currently they create word files and have a master word document with links to the other ones. Of course this would be infinitely better on a website than a word document.

          I think I'll stand up another media wiki.

          @coliver would you do a turnkey or on top of Ubuntu or CentOS? and why?

          1 Reply Last reply Reply Quote 0
          • coliverC
            coliver
            last edited by

            Actually, if I was already invested in O365 I would roll Sharepoint and use the for documentation.

            It is so easy to install doku or mediawiki that I don't think I would go turnkey.

            A 1 Reply Last reply Reply Quote 0
            • A
              Alex Sage @coliver
              last edited by Alex Sage

              @coliver said:

              It is so easy to install doku or mediawiki that I don't think I would go turnkey.

              Which one would you use? or What would you be leaning towards?

              This is for public docs, and private docs so I need some control over who can see what.

              coliverC 1 Reply Last reply Reply Quote 0
              • A
                Alex Sage
                last edited by

                A wiki does seem much simpler 🙂

                DashrenderD 1 Reply Last reply Reply Quote 0
                • DashrenderD
                  Dashrender @Alex Sage
                  last edited by

                  @aaronstuder said:

                  A wiki does seem much simpler 🙂

                  But formatting sucks!

                  coliverC scottalanmillerS 2 Replies Last reply Reply Quote 0
                  • coliverC
                    coliver @Alex Sage
                    last edited by

                    @aaronstuder said:

                    @coliver said:

                    It is so easy to install doku or mediawiki that I don't think I would go turnkey.

                    Which one would you use? or What would you be leaning towards?

                    This is for public docs, and private docs so I need some control over who can see what.

                    I've only ever stood up a MediaWIki server. Dokuwiki looks to be easier to implement. Both can do authentication and authorization. So you wouldn't have any issues locking down certain areas.

                    scottalanmillerS 1 Reply Last reply Reply Quote 1
                    • coliverC
                      coliver @Dashrender
                      last edited by

                      @Dashrender said:

                      @aaronstuder said:

                      A wiki does seem much simpler 🙂

                      But formatting sucks!

                      Really? I've never noticed an issue with formatting. Mediawiki has some plugins that have better WYSIWYG editors but the default one and the syntax are pretty quick the learn.

                      DashrenderD 1 Reply Last reply Reply Quote 0
                      • DashrenderD
                        Dashrender @coliver
                        last edited by

                        @coliver said:

                        @Dashrender said:

                        @aaronstuder said:

                        A wiki does seem much simpler 🙂

                        But formatting sucks!

                        Really? I've never noticed an issue with formatting. Mediawiki has some plugins that have better WYSIWYG editors but the default one and the syntax are pretty quick the learn.

                        having to type '<br>' everywhere to get a carriage return is a huge PITA.

                        coliverC 1 Reply Last reply Reply Quote 0
                        • coliverC
                          coliver
                          last edited by

                          Confluence is nice. The editor is easy to use they do have a strange permissions system that doesn't always work the greatest, but there is a huge overhead in both resources and licensing when you compare to other options.

                          1 Reply Last reply Reply Quote 0
                          • coliverC
                            coliver @Dashrender
                            last edited by

                            @Dashrender said:

                            @coliver said:

                            @Dashrender said:

                            @aaronstuder said:

                            A wiki does seem much simpler 🙂

                            But formatting sucks!

                            Really? I've never noticed an issue with formatting. Mediawiki has some plugins that have better WYSIWYG editors but the default one and the syntax are pretty quick the learn.

                            having to type '<br>' everywhere to get a carriage return is a huge PITA.

                            In Mediawiki? Just hit return twice.

                            1 Reply Last reply Reply Quote 1
                            • DashrenderD
                              Dashrender
                              last edited by

                              I'll stand one up tonight or tomorrow..
                              try again.

                              coliverC 1 Reply Last reply Reply Quote 0
                              • A
                                Alex Sage
                                last edited by

                                http://www.wikimatrix.org/compare/dokuwiki+mediawiki

                                duku seems like the clear winner here...

                                1 Reply Last reply Reply Quote 0
                                • coliverC
                                  coliver @Dashrender
                                  last edited by

                                  @Dashrender said:

                                  I'll stand one up tonight or tomorrow..
                                  try again.

                                  https://www.mediawiki.org/wiki/Help:Formatting

                                  wirestyle22W 1 Reply Last reply Reply Quote 0
                                  • wirestyle22W
                                    wirestyle22 @coliver
                                    last edited by

                                    @coliver said:

                                    @Dashrender said:

                                    I'll stand one up tonight or tomorrow..
                                    try again.

                                    https://www.mediawiki.org/wiki/Help:Formatting

                                    Can you limit access to this?

                                    coliverC 1 Reply Last reply Reply Quote 0
                                    • coliverC
                                      coliver @wirestyle22
                                      last edited by

                                      @wirestyle22 said:

                                      @coliver said:

                                      @Dashrender said:

                                      I'll stand one up tonight or tomorrow..
                                      try again.

                                      https://www.mediawiki.org/wiki/Help:Formatting

                                      Can you limit access to this?

                                      I'm not sure what you mean?

                                      wirestyle22W 1 Reply Last reply Reply Quote 0
                                      • wirestyle22W
                                        wirestyle22 @coliver
                                        last edited by wirestyle22

                                        @coliver said:

                                        @wirestyle22 said:

                                        @coliver said:

                                        @Dashrender said:

                                        I'll stand one up tonight or tomorrow..
                                        try again.

                                        https://www.mediawiki.org/wiki/Help:Formatting

                                        Can you limit access to this?

                                        I'm not sure what you mean?

                                        It's a website correct? What if your documentation are instructions and have sensitive information like IP addresses for remote access etc? I would need to limit access.

                                        coliverC 1 Reply Last reply Reply Quote 0
                                        • coliverC
                                          coliver @wirestyle22
                                          last edited by

                                          @wirestyle22 said:

                                          @coliver said:

                                          @wirestyle22 said:

                                          @coliver said:

                                          @Dashrender said:

                                          I'll stand one up tonight or tomorrow..
                                          try again.

                                          https://www.mediawiki.org/wiki/Help:Formatting

                                          Can you limit access to this?

                                          I'm not sure what you mean?

                                          It's a website correct? What if your documentation are instructions and have sensitive information like IP addresses for remote access etc?

                                          Both MediaWiki and DokuWiki can require authentication for some pages and other pages be completely public.

                                          wirestyle22W 1 Reply Last reply Reply Quote 2
                                          • wirestyle22W
                                            wirestyle22 @coliver
                                            last edited by

                                            @coliver said:

                                            @wirestyle22 said:

                                            @coliver said:

                                            @wirestyle22 said:

                                            @coliver said:

                                            @Dashrender said:

                                            I'll stand one up tonight or tomorrow..
                                            try again.

                                            https://www.mediawiki.org/wiki/Help:Formatting

                                            Can you limit access to this?

                                            I'm not sure what you mean?

                                            It's a website correct? What if your documentation are instructions and have sensitive information like IP addresses for remote access etc?

                                            Both MediaWiki and DokuWiki can require authentication for some pages and other pages be completely public.

                                            That is fantastic. Thank you very much for the recommendation. Very helpful.

                                            1 Reply Last reply Reply Quote 0
                                            • 1
                                            • 2
                                            • 3
                                            • 1 / 3
                                            • First post
                                              Last post